Element: ariaErrorMessageElements 屬性
Element 介面的 ariaErrorMessageElements 屬性是一個數組,其中包含為應用了該屬性的元素提供錯誤訊息的元素(或元素)。
有關該屬性和屬性應如何使用的更多資訊,請參閱 aria-errormessage 主題。
值
一個 HTMLElement 的子類陣列。這些元素的內部文字可以與空格連線起來以獲取錯誤訊息。
讀取時,返回的陣列是靜態的且只讀的。寫入時,將複製分配的陣列:之後對陣列的更改不會影響屬性的值。
描述
該屬性是使用 aria-errormessage 屬性為元素設定錯誤訊息的靈活替代方案。與 aria-errormessage 不同,分配給此屬性的元素不必具有 id 屬性。
當 aria-errormessage 屬性被定義時,該屬性會反映元素的 aria-errormessage 屬性,但僅限於已列出且匹配有效作用域內元素的 ID 值。如果設定了該屬性,則相應的屬性會被清除。有關反射元素引用和作用域的更多資訊,請參閱反射屬性指南中的 反射元素引用。
示例
帶錯誤訊息的電子郵件輸入
本示例演示了我們如何使用 aria-errormessage 為輸入無效電子郵件地址設定錯誤訊息,並演示瞭如何使用 ariaErrorMessageElements 獲取和設定訊息。
HTML
首先,我們定義一個 HTML 電子郵件輸入,將其 aria-errormessage 屬性設定為引用 ID 為 err1 的元素。然後,我們定義一個具有此 ID 的 <span> 元素,其中包含一條錯誤訊息。
CSS
我們建立了一些樣式,預設隱藏錯誤訊息,但在元素的 aria-invalid 屬性設定為 true 時使其可見並顯示為錯誤樣式。
JavaScript
然後,我們檢查輸入,並根據 typeMismatch 約束 violation 將 ariaInvalid 設定為 true 或 false。ariaInvalid 反過來會被反映在 aria-invalid 屬性中,該屬性會根據需要隱藏和顯示錯誤。
然後,我們記錄 aria-errormessage 屬性的值、ariaErrorMessageElements 以及 ariaErrorMessageElements 的內部文字。
結果
當您輸入電子郵件地址時,錯誤文字將顯示出來,直到電子郵件地址有效為止。請注意,日誌顯示了從屬性讀取的錯誤訊息引用、ariaErrorMessageElements 中的元素以及該元素的內部文字,即其錯誤訊息。
規範
| 規範 |
|---|
| 無障礙富網際網路應用程式 (WAI-ARIA) # dom-ariamixin-ariaerrormessageelements |
瀏覽器相容性
載入中…
另見
aria-errormessage屬性ElementInternals.ariaErrorMessageElements- Attribute reflection 指南中的Reflected element references。