dijit.form.CheckBox
Object » dijit._Widget » dijit.form._FormWidget » dijit.form.Button » dijit.form.ToggleButton » dijit.form.CheckBox
dojo.require("dijit.form.CheckBox");
defined in dijit/form/CheckBox.js
User interacts with real html inputs. On onclick (which occurs by mouse click, space-bar, or using the arrow keys to switch the selected radio button), we update the state of the checkbox/radio.
There are two modes: 1. High contrast mode 2. Normal mode In case 1, the regular html inputs are shown and used by the user. In case 2, the regular html inputs are invisible but still used by the user. They are turned quasi-invisible and overlay the background-image.
Usage
function ()
parameter | type | description |
---|---|---|
params | Object | Optional. |
srcNodeRef | DomNode|String |
dijit._Templated (from dijit.form._FormWidget)
FunctionsBack to top
Defined by dijit._Widget, dijit._Templated
Construct the UI for this widget from a template, setting this.domNode.
Defined by dijit._Widget
Connects specified obj/event to specified method of this object and registers for disconnect() on widget destroy. Special event: "ondijitclick" triggers on a click or enter-down or space-up Similar to dojo.connect() but takes three arguments rather than four.
Defined by dijit._Widget, dijit.form._FormWidget
Kick off the life-cycle of a widget
Defined by dijit._Widget, dijit.form._FormWidget
Destroy this widget, but not its descendants
Defined by dijit._Widget
Recursively destroy the children of this widget and their descendants.
Defined by dijit._Widget
Destroy this widget and it's descendants. This is the generic "destructor" function that all widget users should call to cleanly discard with a widget. Once a widget is destroyed, it's removed from the manager object.
Defined by dijit._Widget
Destroys the DOM nodes associated with this widget
Defined by dijit._Widget
Disconnects handle created by this.connect. Also removes handle from this widget's list of connects

Defined by dijit.form._FormWidget
Defined by dijit._Widget
Returns all the widgets that contained by this, i.e., all widgets underneath this.containerNode.

Overrides dijit.form._FormWidget
If the CheckBox is checked, returns the value attribute. Otherwise returns false.
Defined by dijit._Widget, dijit.form._FormWidget
Return true if this widget can currently be focused and false if not
Defined by dijit._Widget
Checks the DOM to for the text direction for bi-directional support

Defined by dijit._Widget
stub function. Override or connect to this method to receive notifications for when the widget moves out of focus.

Defined by dijit.form.Button
user callback for when button is clicked if type="submit", return true to perform submit

Defined by dijit._Widget
Callback if someone tries to close the child, child will be closed if func returns true

Defined by dijit._Widget
stub function. Override or connect to this method to receive notifications for when the widget moves into focus.
get label and set as title on button icon if necessary
Defined by dijit._Widget
Called after the parameters to the widget have been read-in, but before the widget template is instantiated. Especially useful to set properties that are referenced in the widget template.
Defined by dijit._Widget

Overrides dijit.form._FormWidget
Set native HTML attributes reflected in the widget, such as readOnly, disabled, and maxLength in TextBox widgets.
Defined by dijit.form._FormWidget
Set disabled state of widget (Deprecated).
Defined by dijit.form.Button
reset the label (text) of the button; takes an HTML string

Overrides dijit.form._FormWidget
When passed a boolean, controls whether or not the CheckBox is checked. If passed a string, changes the value attribute of the CheckBox (the one specified as "value" when the CheckBox was constructed (ex: <input dojoType="dijit.CheckBox" value="chicken">)

Defined by dijit._Widget
Called after a widget's children, and other widgets on the page, have been created. Provides an opportunity to manipulate any children before they are displayed. This is useful for composite widgets that need to control or layout sub-widgets. Many layout widgets can use this as a wiring phase.

Defined by dijit._Widget
Defined by dijit._Widget
stub function. Override to implement custom widget tear-down behavior.
Defined by dijit._Templated
Iterate through the template and attach functions and nodes accordingly.

Defined by dijit.form.Button, dijit.form.ToggleButton
internal replaceable function for when the button is clicked
Defined by dijit._Templated
relocate source contents to templated container node this.containerNode must be able to receive children, or exceptions will be thrown

Defined by dijit.form._FormWidget
set the value of the widget.
Defined by dijit.form._FormWidget
work around table sizing bugs on FF2 by forcing redraw

Defined by dijit._Widget
Defined by dijit.form.Button
callback when the user mouse clicks the button portion

Defined by dijit._Widget

Defined by dijit.form._FormWidget
Sets _hovering, _active, and stateModifier properties depending on mouse state, then calls setStateClass() to set appropriate CSS classes for this.domNode. To get a different CSS class for hover, send onmouseover and onmouseout events to this method. To get a different CSS class while mouse button is depressed, send onmousedown to this method.
Defined by dijit.form._FormWidget
Update the visual state of the widget by setting the css classes on this.domNode (or this.stateNode if defined) by combining this.baseClass with various suffixes that represent the current widget state(s). In the case where a widget has multiple states, it sets the class based on all possible combinations. For example, an invalid form widget that is being hovered will be "dijitInput dijitInputInvalid dijitInputHover dijitInputInvalidHover". For complex widgets with multiple regions, there can be various hover/active states, such as "Hover" or "CloseButtonHover" (for tab buttons). This is controlled by a stateModifier="CloseButton" attribute on the close button node. The widget may have one or more of the following states, determined by this.state, this.checked, this.valid, and this.selected: Error - ValidationTextBox sets this.state to "Error" if the current input value is invalid Checked - ex: a checkmark or a ToggleButton in a checked state, will have this.checked==true Selected - ex: currently selected tab will have this.selected==true In addition, it may have one or more of the following states, based on this.disabled and flags set in _onMouse (this._active, this._hovering, this._focused): Disabled - if the widget is disabled Active - if the mouse (or space/enter key?) is being pressed down Focused - if the widget has focus Hover - if the mouse is over the widget

Defined by dijit._Templated
PropertiesBack to top
A map of attributes and attachpoints -- typically standard HTML attributes -- to set on the widget's dom, at the "domNode" attach point, by default. Other node references can be specified as properties of 'this'
Defined by dijit.form.ToggleButton
Corresponds to the native HTML <input> element's attribute. In markup, specified as "checked='checked'" or just "checked". True if the button is depressed, or the checkbox is checked, or the radio button is selected, etc.
Defined by dijit._Widget
Defined by dijit._Templated
holds child elements. "containerNode" is generally set via a dojoAttachPoint assignment and it designates where children of the src dom node will be placed
Defined by dijit.form.Button
Defined by dijit._Widget
Unsupported by Dijit, but here for completeness. Dijit only supports setting text direction on the entire document. Bi-directional support, as defined by the [HTML DIR](http://www.w3.org/TR/html401/struct/dirlang.html#adef-dir) attribute. Either left-to-right "ltr" or right-to-left "rtl".
Defined by dijit.form._FormWidget
Should this widget respond to user input? In markup, this is specified as "disabled='disabled'", or just "disabled".
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget, dijit._Templated
this is our visible representation of the widget! Other DOM Nodes may by assigned to other properties, usually through the template system's dojoAttachPonit syntax, but the domNode property is the canonical "top level" node in widget UI.
Defined by dijit._Widget
a unique, opaque ID string that can be assigned by users or by the system. If the developer passes an ID which is known not to be unique, the specified ID is ignored and the system-generated ID is used instead.
Defined by dijit.form._FormWidget
Fires onChange for each value change or only on demand
Defined by dijit._Widget
Rarely used. Overrides the default Dojo locale used to render this widget, as defined by the [HTML LANG](http://www.w3.org/TR/html401/struct/dirlang.html#adef-lang) attribute. Value must be among the list of locales specified during by the Dojo bootstrap, formatted according to [RFC 3066](http://www.ietf.org/rfc/rfc3066.txt) (like en-us).
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit.form._FormWidget
Name used when submitting form; same as "name" attribute or plain HTML elements
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit.form._FormWidget
Should this widget respond to user input? In markup, this is specified as "readOnly". Similar to disabled except readOnly form values are submitted
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit._Templated
a node that represents the widget template. Pre-empts both templateString and templatePath.
Overrides dijit._Templated, dijit.form.Button
Path to template (HTML file) for this widget relative to dojo.baseUrl
Defined by dijit._Templated
a string that represents the widget template. Pre-empts the
Defined by dijit._Widget
Defined by dijit.form.Button
Overrides dijit.form._FormWidget, dijit.form.Button
Corresponds to the native HTML <input> element's attribute.
Overrides dijit.form._FormWidget
equivalent to value field on normal checkbox (if checked, the value is passed as the value when form is submitted)
Defined by dijit._Widget
Defined by dijit._Widget
Defined by dijit._Templated
should we parse the template to find widgets that might be declared in markup inside it? false by default.
Defined by dijit.form._FormWidget
Defined by dijit._Widget
Defined by dijit._Widget
Overrides dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit._Widget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit.form._FormWidget
Defined by dijit._Templated
Defined by dijit._Widget
Defined by dijit._Templated