aria-braillelabel

The global aria-braillelabel property defines a string value that labels the current element, which is intended to be converted into Braille.

Description

The global aria-braillelabel attribute is similar to the global aria-label in that it defines a string value that labels the current element. While aria-label is read by the screen reader, the contents of the aria-braillelabel attribute are converted into Braille; providing the user with a recognizable name of the object in Braille.

The purpose of the aria-braillelabel property is to override how assistive technologies localize and express the accessible name of an element in Braille and should only be used when accessible name, without this attribute, when converted to Braille, would not be the desired user experience.

When using aria-braillelabel, ensure that:

  • The element to which aria-braillelabel is applied has a valid accessible name.
  • The value of aria-braillelabel has actual content and is not empty or only whitespace in unicode or unicode Braille.
  • The value is NOT the same as the accessible name.
  • The aria-braillelabel values are localized to align with the document language.
  • Communicate to the user that this attribute is available, especially if the content contains Unicode Braille Patterns, so the user knows to set the settings to apply user specific braille translations

Note: Assistive Technologies with braille support can convert the accessible names to Braille. Therefore, only use aria-braillelabel when the accessible name is not the user experience you want.

Using only the accessible name, e.g., from content or via aria-label is almost always the better user experience, so don't use aria-braillelabel to replicate aria-label. Only use aria-braillelabel if the accessible name cannot provide an adequate braille representation.

<button aria-braillelabel="***">
  <img alt="3 out of 5 stars" src="three_stars.png">
</button>

A braille display may display "btn ***" in Braille rather than the more verbose "btn gra 3 out of 5 stars".

Values

<string>

The value is a string, an unconstrained value type, that is intended to be converted into Braille.

Associated roles

Used in ALL roles.

Specifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-braillelabel

See Also