Widgets must have owned elements

Rule ID Widget 7
Definition Container widgets must have required owned elements.
Purpose
  • ARIA roles, properties and states describes the features of interactive widgets to users of assistive technologies, especially screen reader users.
  • Roles that are associated with container widgets have important parent/child relationships with other roles.
  • Parent/Child relationships are used by assistive technologies for computing the number of items in a container and the item position.
  • Container roles are also used by assistive technologies to provide enhanced navigation features for moving between items in lists, tables, grids and treegrids.
Mappings
  • HTML4 Legacy Techniques (Required)
  • HTML5 and ARIA Techniques (Required)
WCAG Success Criteria

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

Rule Category Widgets/Scripting
Scope Element
Target Resources Widgets with required owned elements
Techniques
  • Required owned elements can be defined using the HTML DOM structure or the aria-owns attribute.
  • Use the DOM structure to add required owned elements by making them a descendant of the container element.
  • When the owned elements are not descendants of the container element, use the aria-owns attribute on the container element to reference the owned elements.
  • When aria-busy attribute is set to true on the container element, the container element does not need to own any required elements. aria-busy should be used when a container element is being dynamically populated.
  • NOTE: The DOM structure technique is preferred over the aria-owns technique, since it is less likely to result in authoring errors associated with creating and referencing elements with unique ids.
Informational Links