Element : propriété ariaBrailleLabel

Baseline 2024

Nouvellement disponible

Depuis September 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

En savoir plus
Voir la compatibilité complète

La propriété ariaBrailleLabel de l'interface Element reflète la valeur de l'attribut aria-braillelabel, qui définit le label braille ARIA de l'élément.

Ce label d'élément peut être utilisé par les technologies d'assistance capables de présenter du contenu en braille, mais ne doit être défini que si un label spécifique au braille améliore l'expérience utilisateur. L'attribut aria-braillelabel contient des informations supplémentaires sur le moment où la propriété doit être définie.

Valeur

<string>: La valeur est une chaîne de caractères, un type de valeur non contraint, qui est destinée à être convertie en braille.

Exemples

Obtenir et définir `ariaBrailleLabel`

Cet exemple montre comment obtenir et définir la propriété ariaBrailleLabel.

HTML

Tout d'abord, nous définissons un bouton avec le texte du label « 3 sur 5 étoiles » et un attribut aria-braillelabel avec une valeur de "\*\*\*". Cela permet à un affichage braille de montrer "btn ***" en braille plutôt que le plus verbeux « btn gra 3 sur 5 étoiles ».

html

<button id="bouton" aria-braillelabel="\*\*\*">3 sur 5 étoiles</button>

<pre id="journal"></pre>

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

JavaScript

const elementJournal = document.querySelector("#journal");
function journaliser(texte) {
  elementJournal.innerText = `${elementJournal.innerText}${texte}\n`;
  elementJournal.scrollTop = elementJournal.scrollHeight;
}

Le code utilise ensuite la propriété ariaBrailleLabel du bouton pour d'abord obtenir et journaliser le label braille. Il définit ensuite le label braille sur "3*" et journalise à nouveau la valeur.

const bouton = document.getElementById("bouton");
journaliser(bouton.ariaBrailleLabel);
bouton.ariaBrailleLabel = "3*";
journaliser(bouton.ariaBrailleLabel);

Résultat

Spécifications

Spécification
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabraillelabel

Compatibilité des navigateurs

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 11 juil. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu