ElementInternals: ariaDetailsElements-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 ariaDetailsElements-Eigenschaft des ElementInternals-Interfaces ist ein Array, das das Element (oder die Elemente) enthält, die zugängliche Details für das Element bereitstellen, auf das es angewendet wird. Die zugänglichen Details sind ähnlich der zugänglichen Beschreibung (siehe ariaDescribedByElements), bieten jedoch ausführlichere Informationen.

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

Wert

Ein Array von Unterklassen von HTMLElement. Der Innertext dieser Elemente kann mit Leerzeichen verbunden werden, um die zugänglichen Details 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-details-Attributs, um die zugänglichen Details zu setzen. Im Gegensatz zu aria-details müssen die dieser Eigenschaft zugewiesenen Elemente kein id-Attribut haben.

Die Eigenschaft spiegelt das aria-details-Attribut des Elements wider, wenn es definiert ist, jedoch nur für aufgelistete id-Werte, die gültige, im Scoping befindliche Elemente sind. Wenn die Eigenschaft festgelegt wird, wird das entsprechende Attribut gelöscht. Weitere Informationen zu reflektierten Elementreferenzen und zur Reichweite finden Sie unter Reflected element references im Reflected attributes-Leitfaden.

Beispiele

Die Beispiele in den folgenden Dokumenten sind relevant:

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch