Element: ariaInvalid 屬性

Baseline 2023

新推出

自 ⁨2023 年 10 月⁩ 以來，此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

Element 介面的 ariaInvalid 屬性反映了 aria-invalid 屬性的值。對於 application、checkbox、combobox、gridcell、listbox、radiogroup、slider、spinbutton、textbox 和 tree 角色相關，它向輔助技術 API 指示輸入的值是否不符合應用程式期望的格式。

如果該屬性不存在，或者設定為 **空字串**，輔助技術會將該值視為 false。如果該屬性存在但設定為 false、grammar、spelling 或空字串 ("") 以外的值，則輔助技術會將該值視為 true。該屬性反映的是設定的屬性值，而不是由輔助技術處理後的值。

值

一個字串，其值可能為以下之一：

"true": 該元素無效。
"false" (預設): 該元素未處於無效狀態。
"grammar": 該元素處於無效狀態，因為檢測到語法錯誤。
"spelling": 該元素處於無效狀態，因為檢測到拼寫錯誤。

示例

在此示例中，ID 為 quote 的元素的 aria-invalid 屬性被省略，返回 null 並被視為 false。使用 ariaInvalid，我們將值更新為 grammar (因為有兩個錯誤)。

html

<div id="quote" role="textbox" contenteditable>you are your best thing..</div>

<hr />
<pre id="log"></pre>

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

const el = document.getElementById("quote");
log(`Initial value: ${el.ariaInvalid}`);
el.ariaInvalid = "grammar";
log(`Updated value: ${el.ariaInvalid}`);

規範

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

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年4月19日⁩，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤