Combobox Representation

« Accessibility XForms Support Page

Introduction

There are two presentations for XForms select1 elements that are represented by combobox widget. XHTML implementation of select1 element has usual combobox representation you can find below. XUL implementation assumes select1 element is actually container that holds XUL menulist element.

Combobox

Summary

Allows the user to choose a single value from a list of pre-defined values. This representation is used for minimal appearance select1 (see the doc).

Exposed interfaces

• nsIAccessible
• nsIAccessibleText
• nsIAccessibleEditableText
• nsIAccessibleSelectable

Accessibility properties

nsIAccessible

• role - ROLE_COMBOBOX
• name - formed from value of underlying XForms label element
• description - formed from value of underlying XForms hint element
• state - formed from states of instance node that XForms element is bound to
• value - value of bound node that is formed from value of child selected item element

Accessible children

• textfield - ROLE_ENTRY
• dropmarker - ROLE_PUSHBUTTON
• popup with listitems (listbox) - ROLE_LISTBOX
  • xforms:item - ROLE_LISTITEM (see representation listitem below)
  • xforms:choices - ROLE_GROUPING (see representation grouping below)

Note: if select1 element has attribute selection="open" then textfield is editable.

Listitem

Summary

This representation is used for xforms item element that is child element of minimal appearance select1 element. Such select1 element is represented by combobox.

Exposed interfaces

• nsIAccessible
• nsIAccessibleHyperText

Accessibility properties

nsIAccessible

• role - ROLE_LISTITEM
• name - formed from value of underlying XForms label element
• description - formed from value of underlying XForms hint element
• state - STATE_SELECTABLE, STATE_SELECTED
• value - formed from value of underlying XForms value element

Accessible children

Any accessible elements that are child elements of element that this representation is used for.

Grouping

Summary

This representation is used for XForms choices element. XForms choices element is used to group visually XForms item elements.

Exposed interfaces

• nsIAccessible
• nsIAccessibleHyperText

Accessibility properties

nsIAccessible

• role - ROLE_GROUPING
• name - formed from value of underlying XForms label element
• description - formed from value of underlying XForms hint element
• value - there's no value

Accessible children

• item - ROLE_LISTITEM (see listitem representation above)
• choices - ROLE_GROUPING (this representation)