Element: ariaBrailleLabel property

<string>

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

This example shows how to get and set the ariaBrailleLabel property.

HTML

First we define a button with label text "3 out of 5 stars" and an aria-braillelabel attribute with a value of "\*\*\*". This allows a braille display to show "btn ***" in braille rather than the more verbose "btn gra 3 out of 5 stars".

<button id="button" aria-braillelabel="\*\*\*">3 out of 5 stars</button>

<pre id="log"></pre>

#log {
  height: 100px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

The code then uses the button's ariaBrailleLabel property to first get and log the braille label. It then sets the braille label to "3*" and logs the value again.

const button = document.getElementById("button");
log(button.ariaBrailleLabel);
button.ariaBrailleLabel = "3*";
log(button.ariaBrailleLabel);

Result