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

瀏覽器相容性

另見