pagetitle: Screw Default Buttons version 1
-
tagline: Replace the browser defaults for radio buttons and checkboxes with your own custom design.
-
menu: <div id="navcontainer"> <ul id="navlist"> <li id="active"><a href="#" id="active">About</a></li> <li><a href="@root_path/projects">Back to desbest's projects</a></li> </ul> </div>

-
content: # Screw Default Buttons version 1.2.3

ScrewDefaultButtons is a simple jQuery plugin allowing you to replace the browser defaults for radio buttons and checkboxes with your own custom design (image).

Made by <a href="http://mattsolano.com">Matt Solano</a>

Using version 2 is recommended.

## Setup

<b>1 - Link</b>

After downloading the plugin, link to both the jQuery library as well as the ScrewDefaultButtons plugin. You may do this by placing the following lines in the head of your HTML document:

<textarea>
<script src="http://code.jquery.com/jquery-latest.min.js" ></script>
<script src="js/jquery.screwdefaultbuttons.js" ></script> 
</textarea>

<b>2 - Run</b>

Apply the .screwDefaultButtons() method to your radio buttons and/or checkboxes (Note: Must use separate calls). Here is where you will define your replacement images with their height and width. Below is an example:

<textarea>
<script>;
    $(document).ready(function(){
          $('input:radio').screwDefaultButtons({
             checked: "url(images/radio_Checked.jpg)",
             unchecked: "url(images/radio_Unchecked.jpg)",
             width: 85,
             height: 85
          });

          $('input:checkbox').screwDefaultButtons({
             checked: "url(images/checkbox_Checked.jpg)",
             unchecked: "url(images/checkbox_Unchecked.jpg)",
             width: 85,
             height: 85
          });
    });
</script> 
</textarea>

<b>3 - Style</b>

To add things like margin and positioning, you may use the classes .styledRadio and .styledCheckbox in your own css. The following is an example of how it may look:

<textarea>

.styledRadio {
    /* Your styles here */
}

.styledCheckbox {
    /* Your styles here */
}
<textarea>

## More Functionality

<b>Select All</b>

In the case of checkboxes, you have the ability to indicate a "select all" button. Checking this box will select all other checkboxes; Unchecking it will clear all fields; It will also clear if the user unchecks another box. All you have to do is indicate which button should be given this ability:

<textarea>
$('input:checkbox').screwDefaultButtons({
       checked: "url(images/checkbox_Checked.jpg)",
       unchecked: "url(images/checkbox_Unchecked.jpg)",
       width: 85,
       height: 85,
       selectAll: "#selectAllBtn"
});
</textarea>

<b>Preselected Buttons</b>

The 'checked' attribute indicates that a input should be preselected when the page loads. ScrewDefaultButtons will recognize this and make sure your custom radio buttons and checkboxes are also preselected.

<textarea>
<input type="radio" checked="checked">

<input type="checkbox" checked="checked"> 
</textarea>

<b>Disabled Buttons</b>

Custom radio buttons and checkboxes may be disabled by default. In order to do this, you must also specify the disabled version and/or disabled-checked version(when the button is selected and disabled by default). Then, you may apply the disabled attribute as usual in your HTML.

<textarea>
$('input:checkbox').screwDefaultButtons({
       checked: "url(images/checkbox_Checked.jpg)",
       unchecked: "url(images/checkbox_Unchecked.jpg)",
       disabled: "url(images/checkbox_Disabled.jpg)",
       disabledChecked: "url(images/checkbox_disabledChecked.jpg)",
       width: 85,
       height: 85,

});


<input type="checkbox" disabled="disabled" > 
</textarea>

<b>Labels with 'for'</b>

Form labels may be given the 'for' attribute, associating it with an input having a matching id. Feel free to continue doing this as ScrewDefaultButtons will work in the same way. 

<textarea>
<input type="radio" id="large"> <label for="large">Large</label> 
</textarea>

<b>Inherits 'class' and 'onclick'</b>

Due to popular demand, ScrewDefaultButtons now inherits class and onclick attributes applied to the radio buttons and checkboxes in your HTML. This can be used for both styling as well as ensuring that any events you may have created are still triggered.

<textarea>
<input type="radio" class="myRadioButton" >
<input type="checkbox" onclick="myEvent();" > 
</textarea>



-
rightside: <div style="margin-left: 7%;"><div class="dragaction"> <a href="https://gitlab.com/desbest/screw-default-buttons-v1">Download v1.2.3</div></div>

<div style="margin-left: 7%;"><div class="dragaction"> <a href="https://github.com/mattSOLANO/ScrewDefaultButtonsV2">Version 2</div></div>

-
footer: Created by Matt Solano. This is outdated so use version 2 instead.
-