ElementInternals: Eigenschaft ariaBrailleRoleDescription
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.
Die Eigenschaft ariaBrailleRoleDescription der Schnittstelle ElementInternals spiegelt den Wert des Attributs aria-brailleroledescription wider, das die ARIA-Rollenbeschreibung des Elements für Braille definiert.
Diese Eigenschaft kann verwendet werden, um eine gekürzte Version des Werts von aria-roledescription bereitzustellen. Sie sollte nur verwendet werden, wenn aria-roledescription vorhanden ist und in dem seltenen Fall, dass dessen Wert für Braille zu ausführlich ist. Die Dokumentation zu aria-brailleroledescription enthält weitere Informationen dazu, wann die Eigenschaft gesetzt werden sollte.
Wert
Eine Zeichenfolge, die in Braille umgewandelt werden soll.
Beispiele
Angenommen, wir haben ein benutzerdefiniertes Folienelement:
class CustomSlide extends HTMLElement {
constructor() {
super();
this._internals = this.attachInternals();
this._internals.role = "slide";
}
// …
}
customElements.define("custom-slide", CustomSlide);
Wir können den Wert von aria-brailleroledescription des benutzerdefinierten Elements abrufen und festlegen:
const customEl = document.querySelector("custom-slide");
log(customEl._internals.ariaBrailleRoleDescription);
customEl._internals.ariaBrailleRoleDescription = "sd";
log(customEl._internals.ariaBrailleRoleDescription);
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabrailleroledescription |