Element: ariaBrailleLabel-Eigenschaft

Baseline 2024

Neu verfügbar

Seit September 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Die ariaBrailleLabel-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-braillelabel-Attributs wider, welcher das ARIA-Braille-Label des Elements definiert.

Dieses Element-Label kann von unterstützenden Technologien, die Inhalte in Braille darstellen können, verwendet werden. Es sollte jedoch nur gesetzt werden, wenn ein spezifisches Braille-Label die Benutzererfahrung verbessert. Das aria-braillelabel enthält zusätzliche Informationen darüber, wann die Eigenschaft gesetzt werden sollte.

Wert

<string>: Der Wert ist ein String, ein uneingeschränkter Werttyp, der in Braille umgewandelt werden soll.

Beispiele

Abrufen und Festlegen von ariaBrailleLabel

Dieses Beispiel zeigt, wie die ariaBrailleLabel-Eigenschaft abgerufen und festgelegt wird.

HTML

Zuerst definieren wir eine Schaltfläche mit dem Beschriftungstext "3 von 5 Sternen" und einem aria-braillelabel-Attribut mit einem Wert von "***". Dies ermöglicht es einem Braille-Display, "btn ***" in Braille anzuzeigen, anstatt das ausführlichere "btn gra 3 von 5 Sternen".

html

<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;
}

Der Code verwendet dann die ariaBrailleLabel-Eigenschaft der Schaltfläche, um zuerst das Braille-Label abzurufen und zu protokollieren. Anschließend wird das Braille-Label auf "3*" gesetzt und der Wert erneut protokolliert.

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

Ergebnis

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabraillelabel

Browser-Kompatibilität

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden