OpenA11y Evaluation Library

aria-braillelabel is more usable

Rule ID Widget 17
Conformance Required
Definition Use aria-braillelabel attribute when there is more usable Braille label than accessible name.
Purpose
  • The aria-braillelabel property gives authors the ability to override how assistive technologies localize and express the accessible name of an element in Braille.
  • Authors should limit use of aria-braillelabel to instances where the accessible name of an element when converted to Braille can cause confusion.
Conformance Required
WCAG Success Criteria

Success Criterion 2.4.6 Headings and Labels

Other Related Success Criterion:

Rule Category ARIA Widgets
Rule Scope Element
First Step no
aXe Rules
Wave Rules
Techniques
  • aria-braillelabel attribute should only be used by experienced Braille readers or in close consultation with experienced Braille readers.
  • The element to which aria-braillelabel is applied has a valid accessible name.
  • The value of aria-braillelabel is not empty or does not contain only whitespace characters.
  • The value of aria-braillelabel does not contain any characters in Unicode Braille Patterns or consists of only characters in Unicode Braille Patterns; the value does not only contain Braille Pattern dots-0.
  • The value of aria-braillelabel is not identical to the element's accessible name.
  • Important to test the aria-braillelabel with users to verify it improves the user experience.
  • Author is responsible for internationalization of the Braille value
Information Links