ElementInternals:ariaDescribedByElements 属性
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 |
浏览器兼容性
加载中…
另见
aria-describedby
属性Element.ariaDescribedByElements
- Attribute reflection 指南中的 Reflected element references