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

浏览器兼容性

另见