Rule: Accessible name is required

Rule ID Widget 1
Conformance Required
Definition Elements with ARIA widget roles must have an accessible name that describes the purpose of the control.
Purpose
  • An accessible name identifies the purpose or action of a widget on the page.
  • For example when a ARIA widget role receives keyboard focus, both the role and the accessible name is spoken by screen readers.
  • This rule does not test HTML form controls and links, since the accessible name requirement for them is covered in other rules.
Conformance Required
WCAG Success Criteria

Success Criterion 4.1.2 Name, Role, Value

Rule Category ARIA Widgets
Rule Scope Element
Techniques
  • Some ARIA roles allow child text content and alt attribute content from descendant image elements to be used for the accessible name.
  • Use the aria-labelledby attribute to reference the id(s) of visible content on the page to define an accessible name.
  • Use the aria-label attribute to provide an explicit accessible name for an element.
  • Elements with ARIA grouping widget roles may not receive keyboard focus, but giving them a label provides users of assistive technologies a more accurate description of the purpose of the element
Information Links