li element group item semantics

Definition li elements must only have group item role values of listitem (default - do not set), menuitem, menuitemcheckbox, menuitemradio, option, tab, treeitem or presentation.
  • The li element have role restrictions as part of their definition in the W3C HTML5 Specification.
  • When li elements only need to use the role attribute when they are part of interactive widgets and are restricted to widget group item roles.
  • The role values used identify grouping widget roles to ensure that their native grouping semantics are not inadvertently overridden by non-grouping widget or landmark roles.
  • HTML4 Legacy Techniques (Recommended)
  • HTML5 and ARIA Techniques (Required)
WCAG 2.0 Success Criteria

4.1.2 Name, Role, Value (Level A, Primary Success Criterion)

Rule Category Styling/Content
Scope Element
Target Resources li elements
  • The li elements when used as part of widgets must be used to indicate an item in a grouping widget role.
  • In rare cases role="presentation" is allowed on a li element when the element is not being used to represent an item in a list.
Informational Links