ElementInternals: ariaControlsElements 屬性

基準線 2025
新推出

自 ⁨2025 年 4 月⁩起,此功能適用於最新裝置和瀏覽器版本。此功能可能不適用於較舊的裝置或瀏覽器。

ElementInternals 介面的 ariaControlsElements 屬性是一個數組,包含被其應用元素所控制的一個或多個元素。例如,這可以設定在 combobox 上,以指示它彈出的元素;或者設定在 scrollbar 上,以指示它控制的元素的 ID。

關於屬性和 aria-controls 屬性應如何使用,請參閱 aria-controls 主題。

一個由 HTMLElement 的子類組成的陣列,代表由該元素控制的元素。

讀取時,返回的陣列是靜態的且只讀的。寫入時,將複製分配的陣列:之後對陣列的更改不會影響屬性的值。

描述

該屬性是使用 aria-controls 屬性來設定被控制元素的靈活替代方案。與 aria-controls 不同,分配給此屬性的元素不必具有 id 屬性。

aria-controls 屬性定義時,此屬性會反映該屬性,但僅限於列出的、匹配有效作用域內元素的引用 id 值。如果設定了該屬性,則會清除相應的屬性。有關反映的元素引用和作用域的更多資訊,請參閱Reflected attributes 指南中的 Reflected element references

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariacontrolselements

瀏覽器相容性

另見