Accessibility/XForms
<< Back to Accessibility Home Page
AT API support for XForms elements
Assistive technologies API for XForms is supported starting from Firefox 3 (Gecko 1.9). This article provides a short documentation how accessibility is handled in Gecko for XForms.
Below you will find a list of accessible XForms elements.
Forms Controls Module
This section contains a list of accessible form control elements.
input
A key xforms element to show and change the instance data to which it is bound (see the spec, the docs). Accessibility is supported for the following representations of input element:
- text field - default representation, used for most data types, especially text data (see the docs).
- checkbox - used for boolean instance data (see the docs)
- datepicker - default representation for date data types (see the docs).
- calendar - used for date data types when appearance = 'full' (see the docs).
- days list - used when the data has a data type of day (see the docs).
- months list - used when the data has a data type of month (see the docs).
secret
Used for inputting passwords (see the spec, the docs). This element is represented by password field.
textarea
Serves to show/change multiline text (see the spec, the docs). This element is represented by multiline text field.
output
Serves to show instance data that the element is bound to (see the spec, the docs). It can have the following presentations:
- text - default representation for data of most types, especially static text.
- calendar - used for date data types when appearance = 'full'.
upload
Provides a means for the user to select a file (see the spec, the docs).
range
Allows the user to choose a value from within a specific range of values (see the spec, the docs). Currently it is represented by a slider only.
trigger
Allows the user to initiate actions (see the spec, the docs). It can have the following representations:
- button - default representation.
- link/clickable text - used when appearance = 'minimal'.
submit
Invokes the submission of the selected instance data to its target destination (see the spec, the docs). It can have the following representations:
- button - default representation.
- link/clickable text - used when appearance = 'minimal'.
select
Allows the user to choose one or multiple values from a list of pre-defined values (see the spec, the docs). It can have the following representations:
- listbox - default representation
- checkbox group - used when appearance = 'full'
select1
Allows the user to choose a single value from a list of pre-defined values (see the spec, the docs). It can have the following representations:
- combobox - default representation
- listbox - used when appearance = 'compact'
- radio group - used when appearance = 'full'
Additional Elements
These elements may be used as child elements to the form controls described above. Some of these elements are not accessible itself but they makes accessibility properties for XForms elements that hold them.
label
Specifies the label for the xforms control (see the spec, the docs). Every form control other than the output element must contain a label element. The value of label element is used as name of accessible object.
help
Specifies contextual help for the containing form control (see the spec, the docs). The help element has alert role.
hint
Similar to a tooltip (see the spec, the docs). The value of hint element is used as description of accessible object.
alert
This message will be shown when the form control cannot properly bind to instance data or when the instance data value is invalid or out of the specified range of selectable values (see the spec, the docs). The alert element has alert role for both usual and inline alert elements.
message
Used in combination with event listeners to display a message to the user when the specified event occurs (see the spec, the docs). The message element has alert role.