The range element
Release 2.0 - ...
This form control allows selection from a sequential range of values.
Example
| XML |
Copy Code
|
|---|---|
<xforms:range ref="/car/year" start="1975" end="2011" step="1"> <xforms:label>Model Year : </xforms:label> </xforms:range> |
|
Attributes
| Name | Required / optional | Description |
|---|---|---|
| start | optional | Attribute containing a hint for the lexical starting bound for the range - a legal value for the underlying data. If provided, this value is used to further refine the constraints specified by the underlying model. |
| end | optional | Attribute containing a hint for the ending bound for the range - a legal value for the underlying data. If provided, this value is used to further refine the constraints specified by the underlying model. |
| step | optional | Attribute containing a delta-value to use for incrementing or decrementing the value. Must be of a type capable of expressing the difference between two legal values of the underlying data. |
| incremental | optional | When true, this form control will generate additional xforms-value-changed events. The default value is false. |
| Common Attributes | optional | Any attribute from the Common Attributes collection (e.g. id). |
| Single Node Binding Attributes | required | One or more attributes from the Single Node Binding Attributes group (ref, model, bind). |
| UI Common Attributes | optional | Any attribute from the UI Common Attributes group (appearance, class, navindex, accesskey). |
Content
Within an range element, the following child elements are allowed:
| Element Name | Required / optional | Description |
|---|---|---|
| label | required | Provides a descriptive label for the containing form control |
| help | optional | Provides a help message for the containing form control. |
| hint | optional | Provides a hint message for the containing form control. |
| alert | optional | Provides an alert or error message for the containing form control. |
| Action element(s) | optional | Any element from the Action Elements Collection. |
Specification
Link to the XForms specification: the range element.