ElementInternals: ariaDetailsElements 属性

基准线 2025
新推出

自 ⁨2025 年 4 月⁩起,此功能适用于最新设备和浏览器版本。此功能可能不适用于较旧的设备或浏览器。

ElementInternals 接口的 ariaDetailsElements 属性是一个数组,包含为应用它的元素提供可访问详细信息的元素。可访问详细信息类似于可访问描述(参见 ariaDescribedByElements),但提供更详细的信息。

aria-details 主题包含有关如何使用此属性和属性的更多信息。

HTMLElement 的子类组成的数组。这些元素的内部文本可以连接空格来获取可访问的详细信息。

读取时,返回的数组是静态的且只读的。写入时,将复制分配的数组:之后对数组的更改不会影响属性的值。

描述

该属性是使用 aria-details 属性设置可访问详细信息的灵活替代方案。与 aria-details 不同,分配给此属性的元素不必具有 id 属性。

该属性反映了元素在定义时的 aria-details 属性,但仅限于列出的、与有效的范围内的元素匹配的引用 id 值。如果设置了该属性,则相应的属性会被清除。有关反射元素引用和范围的更多信息,请参阅反射属性指南中的 反射元素引用

示例

以下文档中的示例是相关的

  • Element.ariaDetailsElements 是此属性的 DOM 等效项。它的用法与此相同,但它作用于 DOM 而非 Shadow DOM 和/或自定义元素。

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# dom-ariamixin-ariadetailselements

浏览器兼容性

另见