Accessibility:XForms:Combobox

From MDC

« Accessibility XForms Support Page

Contents 1 Introduction 2 Combobox 2.1 Summary 2.2 Exposed interfaces 2.3 Accessibility properties 2.3.1 nsIAccessible 2.3.2 Accessible children 3 Listitem 3.1 Summary 3.2 Exposed interfaces 3.3 Accessibility properties 3.3.1 nsIAccessible 3.4 Accessible children 4 Grouping 4.1 Summary 4.2 Exposed interfaces 4.3 Accessibility properties 4.3.1 nsIAccessible 4.4 Accessible children

[edit] 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.

[edit] Combobox

[edit] 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).

[edit] Exposed interfaces

• nsIAccessible
• nsIAccessibleText
• nsIAccessibleEditableText
• nsIAccessibleSelectable

[edit] Accessibility properties

[edit] 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

[edit] 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.

[edit] Listitem

[edit] 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.

[edit] Exposed interfaces

• nsIAccessible
• nsIAccessibleHyperText

[edit] Accessibility properties

[edit] 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

[edit] Accessible children

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

[edit] Grouping

[edit] Summary

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

[edit] Exposed interfaces

• nsIAccessible
• nsIAccessibleHyperText

[edit] Accessibility properties

[edit] 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

[edit] Accessible children

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