aria-braillelabel or aria-brailleroledescription has no equivalent

What’s wrong

An element sets aria-braillelabel or aria-brailleroledescription without a matching aria-label (or accessible name) and aria-roledescription. Braille display users get a different label than screen reader speech users.

Why it matters

The braille attributes exist to shorten labels for refreshable braille displays, not to replace the spoken label entirely. When the two diverge, someone reading braille and someone listening to speech end up with different information about the same control.

How to fix it

Keep the braille label as a shorter version of the same accessible name, never a different one.

<button aria-braillelabel="Save">Save this document to your account</button>

<button aria-label="Save this document to your account" aria-braillelabel="Save">
  Save this document to your account
</button>

Learn more

• WCAG Understanding 4.1.2
• MDN: aria-braillelabel