Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 sein Wert in dem seltenen Fall 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 Element für eine Folie:

js
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 auslesen und festlegen:

js
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

Browser-Kompatibilität

Siehe auch