ElementInternals: ariaErrorMessageElements 屬性

基準線 2025
新推出

自 ⁨2025 年 4 月⁩起,此功能適用於最新裝置和瀏覽器版本。此功能可能不適用於較舊的裝置或瀏覽器。

ElementInternals 介面的 ariaErrorMessageElements 屬性是一個數組,其中包含為應用了它的元素提供錯誤訊息的元素(一個或多個)。

有關該屬性和值的用法,請參閱 aria-errormessage 主題。

一個 HTMLElement 的子類的陣列。這些元素的內部文字可以與空格連線起來以獲取錯誤訊息。

讀取時,返回的陣列是靜態的且只讀的。寫入時,將複製分配的陣列:之後對陣列的更改不會影響屬性的值。

描述

此屬性是使用 aria-errormessage 屬性為元素設定錯誤訊息的靈活替代方案。與 aria-errormessage 不同,分配給此屬性的元素不必具有 id 屬性。

當定義了元素的 aria-errormessage 屬性時,此屬性會反映該屬性,但僅限於已列出的、匹配有效範圍內元素的引用 id 值。如果設定了此屬性,則對應的屬性會被清除。有關反射的元素引用和範圍的更多資訊,請參閱反射屬性指南中的 Reflected element references

示例

以下文件中的示例是相關的

  • Element.ariaErrorMessageElements 是此屬性的 DOM 等效項。它的用法相同,但在 DOM 中而不是在 Shadow DOM 和/或自定義元素中使用。

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariaerrormessageelements

瀏覽器相容性

另見