ElementInternals: ariaRoleDescription-Eigenschaft

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaRoleDescription-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-roledescription-Attributs wider, welches eine für Menschen lesbare und vom Autor lokalisierte Beschreibung der Rolle eines Elements definiert.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantik für ein benutzerdefiniertes Element festzulegen. Diese können von vom Autor definierten Attributen überschrieben werden, sichern jedoch, dass die Standardsemantik erhalten bleibt, sollten die Autoren diese Attribute löschen oder sie überhaupt nicht hinzufügen. Weitere Informationen finden Sie im Accessibility Object Model-Erklärer.

Wert

Ein String.

Beispiele

In diesem Beispiel wird der Wert von ariaRoleDescription auf "My custom widget" gesetzt.

js
this.internals_.ariaRoleDescription = "My custom widget";

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaroledescription

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch