ElementInternals: ariaControlsElements-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 ariaControlsElements-Eigenschaft des ElementInternals-Interfaces ist ein Array, das das oder die Elemente enthält, die von dem Element gesteuert werden, auf das es angewendet wird. Zum Beispiel könnte dies auf einem Combobox gesetzt werden, um das Element anzuzeigen, das es öffnet, oder auf einem Scrollbar, um die ID des Elements anzuzeigen, das es steuert.

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

Wert

Ein Array von Unterklassen von HTMLElement, das die Elemente repräsentiert, die von diesem Element gesteuert werden.

Beim Lesen ist das zurückgegebene Array statisch und schreibgeschützt. Beim Schreiben wird das zugewiesene Array kopiert: Nachfolgende Änderungen an dem Array wirken sich nicht auf den Wert der Eigenschaft aus.

Beschreibung

Die Eigenschaft ist eine flexible Alternative zur Verwendung des aria-controls-Attributs, um die gesteuerten Elemente festzulegen. Anders als bei aria-controls müssen die Elemente, die dieser Eigenschaft zugewiesen sind, kein id-Attribut haben.

Die Eigenschaft spiegelt das aria-controls-Attribut wider, wenn es definiert ist, jedoch nur für aufgelistete id-Referenzwerte, die gültigen, im Bereich befindlichen Elementen entsprechen. Wenn die Eigenschaft gesetzt ist, wird das entsprechende Attribut gelöscht. Weitere Informationen über reflektierte Elementreferenzen und Bereich finden Sie unter Reflektierte Elementreferenzen im Reflected attributes-Leitfaden.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch