behavior:check
Standard checkbox button implementation. Can be applied to any element to toggle :checked state on it.
Elements
that have this behavior applied by default:
<input type="checkbox">- standard HTML inline checkbox button;<button type="checkbox">- Windows like inline checkbox button, use it as<button type=checkbox >caption</button>.
Attributes
that this behavior knows about:
checked- if provided will initialize value of runtime state of the flag checked.name="name"- standard attribute name - name of the input element on a form.value="..."- standard value attribute (used bybehavior:form).as="string | integer | float | numeric | auto"- defines how value propert is reported to script. By default value of element withvalue="42"will be just as a string"42"butvalue="42" as="integer"will yield integer42.mixed- this element allows to be in mixed (undetermined) state.
Events
Together with the standard set of events (mouse, keyboard, focus) behavior:check generates:
"input"|"change"/BUTTON_STATE_CHANGED event - the button just changed its state to checked. Asynchronous event."press"/BUTTON_PRESS event - mouse down orspacebarkey down when button is in focus. Synchronous event.
Value
If value is requested from the element directly then value will have true or false values - reflects current status of :checked state flag.
For mixed checkbox the behavior also accepts null value - undetermined state.
If checkbox element is placed inside a <form> then form's value collection will include value of checkbox@value attribute if it is checked.
Methods
N/A - behavior:check does not introduce any specific methods.