dijit.form.ToggleButton

Status:Draft
Version:1.0
Authors:Doug Hays
Developers:?-
Available:since V?

ToggleButton widgets are a cross between Button and Checkbox widgets. They are created like Button widgets, but like CheckBox widgets, they maintain a checked boolean attribute (settable/gettable) that toggles on each click action. Unlike CheckBox widgets however, ToggleButton widgets do not submit any value on FORM submit. They are used solely for client-side processing where the user can toggle between 2 states before performing some additional action. The CSS class “dijitToggleButtonChecked” is appended to the widget’s outermost DOM node when the checked attribute is true to allow for custom styling.

Examples

Programmatic example

Let’s create a ToggleButton widget programatically, initially unchecked:

<script type="text/javascript">
dojo.require("dijit.form.Button");
dojo.addOnLoad(function(){
  new dijit.form.ToggleButton({
    showLabel: true,
    checked: false,
    onChange: function(val){this.attr('label',val)},
    label: "false"
  }, "programmatic");
});
</script>
<button id="programmatic"><button>

Declarative example

Now let’s create a ToggleButton widget with HTML markup, initially checked:

<script type="text/javascript">
    dojo.require("dijit.form.Button");
</script>
<button dojoType="dijit.form.ToggleButton" checked iconClass="dijitCheckBoxIcon">
    Toggle me
</button>

Accessibility

Keyboard

Action Key
Navigate to a ToggleButton Tab
Toggle checked state Spacebar