Main content

listbox

Characteristics

Superclass Role:

  • list
  • select

Related Concepts:

  • HTML select
  • XForms select

See Related:

  • combobox
  • list

Required Owned Elements:

  • option

Supported States and Properties:

  • aria-multiselectable
  • aria-required

Inherited States and Properties:

  • aria-activedescendant
  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-expanded (state)
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • author

Accessible Name Required:

  • True

A widget that allows the user to select one or more items from a list of choices.

Listbox (role) is similar to a combobox role or a checkbox role. Unlike a combobox role, in listbox role the user can select more than one option.

Items within the list are static and, unlike standard HTML select elements, may contain images. List boxes contain children whose role is option.

To be keyboard accessible, authors should manage focus of descendants for all instances of this role.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_LIST

UI Automation ControlType Property: 

  • List

UI Automation AriaRole Property: 

  • listbox
More in this category: « listitem list »