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

瀏覽器相容性

另見