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.
Purpose
  • 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.
Required No for HTML4 Legacy Techniques ruleset mapping
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
Techniques
  • 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