ElementInternals: ariaBrailleRoleDescription-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.
Die ariaBrailleRoleDescription-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-brailleroledescription-Attributs wider, welches die ARIA-Braillerollenbeschreibung des Elements definiert.
Diese Eigenschaft kann verwendet werden, um eine verkürzte Version des aria-roledescription-Wertes bereitzustellen. Sie sollte nur verwendet werden, wenn aria-roledescription vorhanden ist und in seltenen Fällen, in denen diese für Braille zu ausführlich ist. Das aria-brailleroledescription enthält zusätzliche Informationen darüber, wann die Eigenschaft gesetzt werden sollte.
Wert
Ein String, der in Braille umgewandelt werden soll.
Beispiele
Angenommen, wir haben ein benutzerdefiniertes Slide-Element:
class CustomSlide extends HTMLElement {
constructor() {
super();
this._internals = this.attachInternals();
this._internals.role = "slide";
}
// …
}
customElements.define("custom-slide", CustomSlide);
Wir können den Wert der aria-brailleroledescription-Eigenschaft des benutzerdefinierten Elements abrufen und setzen:
const customEl = document.querySelector("custom-slide");
log(customEl.ariaBrailleRoleDescription);
customEl.ariaBrailleRoleDescription = "sd";
log(customEl.ariaBrailleRoleDescription);
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabrailleroledescription |