Main content

list

Characteristics

Superclass Role:

  • region

Subclass Roles:

  • directory
  • listbox
  • menu

Base Concept:

  • HTML ul
  • HTML ol

Required Owned Elements:

  • group → listitem
  • listitem

See Related:

  • listbox

Inherited States and Properties:

  • 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

A group of non-interactive list items.

Sometimes content developers want to put together few bulleted points. As per HTML semantics, any related elements having more than 3 items should be wrapped in HTML lists. Due to various reasons, HTML lists might not be possible. In such scenarios, aria list role can be used. In the < div> containing the items just add the role="list" and that should do the magic.

Lists contain children whose role is listitem, or elements whose role is group which in turn contains children whose role is listitem.

Syntax

<div role="list">List Items</div>

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_LIST

UI Automation ControlType Property: 

  • List

UI Automation AriaRole Property: 

  • list
More in this category: « listbox link »