ElementInternals:ariaDescribedByElements 属性

基准线 2025
新推出

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

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

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

一个 HTMLElement HTMLElement 的子类数组。这些元素的内部文本可以与空格连接起来以获得可访问的描述。

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

描述

该属性是使用 aria-describedby 属性来设置可访问描述的灵活替代方案。与 aria-describedby 不同,分配给此属性的元素不必具有 id 属性。

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

示例

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

  • Element.ariaDescribedByElements 是此属性的 DOM 等效项。它的用法与此相同,但在 DOM 中使用,而不是在 Shadow DOM 和/或自定义元素中使用。

规范

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

浏览器兼容性

另见