ARIA 狀態和屬性（attributes）

本頁列出了涵蓋 MDN 上討論的所有 WAI-ARIA 屬性的參考頁面。

ARIA 屬效能夠修改輔助功能樹中定義的元素的**狀態和屬性**。

注意：ARIA 只修改輔助功能樹，改變輔助技術向用戶呈現內容的方式。ARIA 不改變元素的任何功能或行為。當不使用語義化 HTML 元素實現其預期目的和預設功能時，您必須使用 JavaScript 來管理行為、焦點和 ARIA 狀態。

ARIA 屬性型別

ARIA 狀態和屬性分為 4 個類別

小部件屬性

即時區域屬性

拖放屬性

關係屬性

全域性 ARIA 屬性

某些狀態和屬性適用於所有 HTML 元素，無論是否應用了 ARIA 角色。這些被定義為“全域性”屬性。全域性狀態和屬性受到所有角色和基本標記元素的支援。

上述許多屬性都是全域性的，這意味著它們可以包含在任何元素上，除非特別禁止

所謂“特別禁止”，是指上述所有屬性都是全域性的，除了 aria-label 和 aria-labelledby 屬性，它們不允許用於角色為 presentation 或其同義詞 none 的元素。

狀態和屬性索引

以下是涵蓋 MDN 上描述的 WAI-ARIA 狀態和屬性的參考頁面。

ARIA: aria-activedescendant 屬性: 當焦點在一個 composite 小部件、combobox、textbox、group 或 application 上時，aria-activedescendant 屬性用於識別當前活動元素。
ARIA: aria-atomic 屬性: 在 ARIA 即時區域中，全域性 aria-atomic 屬性指示輔助技術（如螢幕閱讀器）是根據 aria-relevant 屬性定義的更改通知來呈現更改區域的全部內容還是部分內容。
ARIA: aria-autocomplete 屬性: aria-autocomplete 屬性指示輸入文字是否會觸發顯示一個或多個對使用者 combobox、searchbox 或 textbox 的預期值的預測，並指定如果進行預測，它們將如何呈現。
ARIA: aria-braillelabel 屬性: 全域性 aria-braillelabel 屬性定義了一個字串值，用於標記當前元素，該值旨在轉換為盲文。
ARIA: aria-brailleroledescription 屬性: 全域性 aria-brailleroledescription 屬性定義了一個人類可讀的、作者本地化的縮寫描述，用於元素的角色，該描述旨在轉換為盲文。
ARIA: aria-busy 屬性: aria-busy 屬性是一個全域性 ARIA 狀態，指示元素當前是否正在被修改。它幫助輔助技術理解內容更改尚未完成，並且它們可能需要在通知使用者更新之前等待。雖然 aria-busy 通常用於 ARIA 即時區域以延遲公告直到更新完成，但它也可以用於即時區域之外——例如，在小部件或提要中——以指示正在進行的更改或載入。
ARIA: aria-checked 屬性: aria-checked 屬性指示覆選框、單選按鈕和其他小部件的當前“選中”狀態。
ARIA: aria-colcount 屬性: 當並非所有列都存在於 DOM 中時，aria-colcount 屬性定義 table、grid 或 treegrid 中的總列數。
ARIA: aria-colindex 屬性: aria-colindex 屬性定義元素相對於 table、grid 或 treegrid 中總列數的列索引或位置。
ARIA: aria-colindextext 屬性: aria-colindextext 屬性定義了數字 aria-colindex 的人類可讀文字替代。
ARIA: aria-colspan 屬性: aria-colspan 屬性定義 table、grid 或 treegrid 中單元格或網格單元格跨越的列數。
ARIA: aria-controls 屬性: 全域性 aria-controls 屬性識別其內容或存在受此屬性設定的元素控制的元素（或多個元素）。
ARIA: aria-current 屬性: 元素上非空的 aria-current 狀態表示此元素代表容器或一組相關元素中的當前項。
ARIA: aria-describedby 屬性: 全域性 aria-describedby 屬性識別描述了設定此屬性的元素的元素（或多個元素）。
ARIA: aria-description 屬性: 全域性 aria-description 屬性定義了一個字串值，用於描述或註釋當前元素。
ARIA: aria-details 屬性: 全域性 aria-details 屬性識別提供了與物件相關的額外資訊的元素（或多個元素）。
ARIA: aria-disabled 屬性: aria-disabled 狀態表示元素可見但被停用，因此不可編輯或不可操作。
ARIA: aria-dropeffect 屬性: 全域性 aria-dropeffect 屬性指示當拖動的物件釋放到放置目標上時可能執行的功能。
ARIA: aria-errormessage 屬性: 物件上的 aria-errormessage 屬性標識了為該物件提供錯誤訊息的元素。
ARIA: aria-expanded 屬性: aria-expanded 屬性設定在元素上，以指示控制元件是展開還是摺疊，以及受控制的元素是顯示還是隱藏。
ARIA: aria-flowto 屬性: 全域性 aria-flowto 屬性標識了內容替代閱讀順序中的下一個元素（或多個元素）。這允許輔助技術在使用者酌情決定時覆蓋按文件源順序閱讀的一般預設行為。
ARIA: aria-grabbed 屬性: aria-grabbed 狀態指示元素在拖放操作中的“被抓取”狀態。
ARIA: aria-haspopup 屬性: aria-haspopup 屬性指示可由設定了該屬性的元素觸發的互動式彈出元素的可用性和型別。
ARIA: aria-hidden 屬性: aria-hidden 狀態指示元素是否暴露給輔助功能 API。
ARIA: aria-invalid 屬性: aria-invalid 狀態表示輸入的值不符合應用程式預期的格式。
ARIA: aria-keyshortcuts 屬性: 全域性 aria-keyshortcuts 屬性指示作者為啟用或聚焦元素而實現的鍵盤快捷鍵。
ARIA: aria-label 屬性: aria-label 屬性定義了一個字串值，可用於命名元素，只要元素的角色不禁止命名。
ARIA: aria-labelledby 屬性: aria-labelledby 屬性識別標記了應用它的元素的元素（或多個元素）。
ARIA: aria-level 屬性: aria-level 屬性定義元素在結構中的層次級別。
ARIA: aria-live 屬性: 全域性 aria-live 屬性指示元素將更新，並描述使用者代理、輔助技術和使用者可以從即時區域中預期的更新型別。
ARIA: aria-modal 屬性: aria-modal 屬性指示元素顯示時是否為模態。
ARIA: aria-multiline 屬性: aria-multiline 屬性指示 textbox 是接受多行輸入還是隻接受單行輸入。
ARIA: aria-multiselectable 屬性: aria-multiselectable 屬性指示使用者可以從當前可選的後代中選擇多個項。
ARIA: aria-orientation 屬性: aria-orientation 屬性指示元素的方向是水平、垂直還是未知/不明確。
ARIA: aria-owns 屬性: 當 DOM 層次結構無法表示父元素與其子元素之間的關係時，aria-owns 屬性識別一個或多個元素，以定義它們之間的視覺、功能或上下文關係。
ARIA: aria-placeholder 屬性: aria-placeholder 屬性定義了一個簡短的提示（一個詞或短語），旨在幫助使用者在表單控制元件沒有值時輸入資料。該提示可以是示例值或預期格式的簡要描述。
ARIA: aria-posinset 屬性: 當並非所有專案都存在於 DOM 中時，aria-posinset 屬性定義元素在當前列表項或樹項集中的編號或位置。
ARIA: aria-pressed 屬性: aria-pressed 屬性指示切換按鈕的當前“按下”狀態。
ARIA: aria-readonly 屬性: aria-readonly 屬性指示元素不可編輯，但其他方面可操作。
ARIA: aria-relevant 屬性: 在 ARIA 即時區域中使用，全域性 aria-relevant 屬性指示當即時區域內的輔助功能樹被修改時，使用者代理將觸發哪些通知。
ARIA: aria-required 屬性: aria-required 屬性指示在提交表單之前，元素上需要使用者輸入。
ARIA: aria-roledescription 屬性: aria-roledescription 屬性定義了元素角色的一個人性化、作者本地化的描述。
ARIA: aria-rowcount 屬性: aria-rowcount 屬性定義表、網格或樹網格中的總行數。
ARIA: aria-rowindex 屬性: aria-rowindex 屬性定義了元素在表、網格或樹網格中相對於總行數的位置。
ARIA: aria-rowindextext 屬性: aria-rowindextext 屬性定義了 aria-rowindex 的人類可讀文字替代。
ARIA: aria-rowspan 屬性: aria-rowspan 屬性定義了表、網格或樹網格中單元格或網格單元格跨越的行數。
ARIA: aria-selected 屬性: aria-selected 屬性指示各種小部件的當前“選中”狀態。
ARIA: aria-setsize 屬性: 當集合中的所有專案都不存在於 DOM 中時，aria-setsize 屬性定義當前列表項或樹項集合中的專案數。
ARIA: aria-sort 屬性: aria-sort 屬性指示表或網格中的專案是按升序還是降序排序。
ARIA: aria-valuemax 屬性: aria-valuemax 屬性定義範圍小部件允許的最大值。
ARIA: aria-valuemin 屬性: aria-valuemin 屬性定義範圍小部件允許的最小值。
ARIA: aria-valuenow 屬性: aria-valuenow 屬性定義 range 小部件的當前值。
ARIA: aria-valuetext 屬性: aria-valuetext 屬性定義了範圍小部件 aria-valuenow 的人類可讀文字替代。

另見

使用 ARIA：角色、狀態和屬性

幫助改進 MDN

瞭解如何貢獻

此頁面由 MDN 貢獻者在 2025 年 3 月 6 日最後修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題