ElementInternals: ariaDescribedByElements-Eigenschaft

Baseline 2025
Newly available

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

Die ariaDescribedByElements-Eigenschaft des ElementInternals-Interfaces ist ein Array, das das Element (oder die Elemente) enthält, die eine zugängliche Beschreibung für das Element bereitstellen, auf das es angewendet wird. Die zugängliche Beschreibung ist ähnlich wie das zugängliche Label (siehe ariaLabelledByElements), bietet jedoch ausführlichere Informationen.

Das Thema aria-describedby enthält zusätzliche Informationen darüber, wie das Attribut und die Eigenschaft verwendet werden sollten.

Wert

Ein Array von Unterklassen von HTMLElement. Der innere Text dieser Elemente kann mit Leerzeichen verbunden werden, um die zugängliche Beschreibung zu erhalten.

Beim Lesen ist das zurückgegebene Array statisch und schreibgeschützt. Beim Schreiben wird das zugewiesene Array kopiert: Nachfolgende Änderungen am Array beeinflussen den Wert der Eigenschaft nicht.

Beschreibung

Die Eigenschaft ist eine flexible Alternative zur Verwendung des aria-describedby-Attributs, um die zugängliche Beschreibung festzulegen. Im Gegensatz zu aria-describedby müssen die Elemente, die dieser Eigenschaft zugeordnet sind, kein id-Attribut haben.

Die Eigenschaft spiegelt das aria-describedby-Attribut des Elements wider, wenn es definiert ist, jedoch nur für aufgelistete Referenz-id-Werte, die mit gültigen Elementen im Gültigkeitsbereich übereinstimmen. Wenn die Eigenschaft gesetzt ist, wird das entsprechende Attribut gelöscht. Weitere Informationen über die Reflektion von Elementreferenzen und den Gültigkeitsbereich finden Sie unter Reflektierte Elementreferenzen im Reflektierte Attribute-Leitfaden.

Beispiele

Die Beispiele in den folgenden Dokumenten sind relevant:

  • Element.ariaDescribedByElements ist das DOM-Äquivalent dieser Eigenschaft. Sie wird auf die gleiche Weise verwendet, jedoch innerhalb des DOM statt eines Shadow-DOM und/oder benutzerdefinierten Elements.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch