ARIA 狀態和屬性
此頁面列出了涵蓋 MDN 上討論的所有 WAI-ARIA 屬性的參考頁面。
ARIA 屬性使您可以修改元素的狀態和屬性，如輔助功能樹中所定義。
注意：ARIA 僅修改輔助功能樹，修改輔助技術向用戶呈現內容的方式。ARIA 不會更改元素的任何功能或行為。當不將語義 HTML 元素用於其預期目的和預設功能時，必須使用 JavaScript 來管理行為、焦點和 ARIA 狀態。
ARIA 屬性型別
ARIA 狀態和屬性有 4 類
-
小部件屬性
aria-autocompletearia-checkedaria-disabledaria-errormessagearia-expandedaria-haspopuparia-hiddenaria-invalidaria-labelaria-levelaria-modalaria-multilinearia-multiselectablearia-orientationaria-placeholderaria-pressedaria-readonlyaria-requiredaria-selectedaria-sortaria-valuemaxaria-valueminaria-valuenowaria-valuetext
-
即時區域屬性
-
拖放屬性
-
關係屬性
全域性 ARIA 屬性
某些狀態和屬性適用於所有 HTML 元素，無論是否應用 ARIA 角色。這些被定義為“全域性”屬性。全域性狀態和屬性受所有角色和基本標記元素支援。
上述許多屬性都是全域性的，這意味著它們可以包含在任何元素上，除非明確禁止。
aria-atomicaria-busyaria-controlsaria-currentaria-describedbyaria-descriptionaria-detailsaria-disabledaria-dropeffectaria-errormessagearia-flowtoaria-grabbedaria-haspopuparia-hiddenaria-invalidaria-keyshortcutsaria-labelaria-labelledbyaria-livearia-ownsaria-relevantaria-roledescription
透過“明確禁止”，所有上述屬性都是全域性的，除了aria-label 和aria-labelledby 屬性，它們不允許在角色為presentation 或其同義詞none 角色的元素上使用。
在 MDN 上定義的狀態和屬性
以下是涵蓋 MDN 上討論的 WAI-ARIA 狀態和屬性的參考頁面。
- aria-activedescendant
aria-activedescendant屬性標識當焦點位於composite小部件、combobox、textbox、group或application時當前活動的元素。- aria-atomic
在 ARIA 即時區域中，全域性
aria-atomic屬性指示諸如螢幕閱讀器之類的輔助技術是否會根據aria-relevant屬性定義的更改通知呈現更改區域的所有內容或僅呈現部分內容。- aria-autocomplete
aria-autocomplete屬性指示輸入文字是否可以觸發顯示使用者為combobox、searchbox或textbox設定的預期值的預測，並指定如果做出預測，將如何呈現預測。- aria-braillelabel
全域性
aria-braillelabel屬性定義一個字串值，該值對當前元素進行標記，該元素旨在轉換為盲文。- aria-brailleroledescription
全域性
aria-brailleroledescription屬性定義一個面向人類的可讀的、作者本地化的簡短描述，用於元素的角色，該角色旨在轉換為盲文。- aria-busy
在ARIA 即時區域 中使用，全域性
aria-busy狀態指示元素正在修改，並且輔助技術可能希望等到更改完成後再通知使用者更新。- aria-checked
aria-checked屬性指示覆選框、單選按鈕和其他小部件的當前“選中”狀態。- aria-colcount
aria-colcount屬性定義table、grid或treegrid中的總列數，當並非所有列都存在於DOM 中時。- aria-colindex
aria-colindex屬性定義元素相對於table、grid或treegrid中總列數的列索引或位置。- aria-colindextext
aria-colindextext屬性定義數字aria-colindex的面向人類的可讀文字替代。- aria-colspan
- aria-controls
全域性
aria-controls屬性標識其內容或存在受設定此屬性的元素控制的元素（或元素）。- aria-current
元素上的非空
aria-current狀態表示該元素代表容器或一組相關元素中的當前項。- aria-describedby
全域性
aria-describedby屬性標識描述設定該屬性的元素的元素（或元素）。- aria-description
全域性
aria-description屬性定義一個字串值，用於描述或註釋當前元素。- aria-details
全域性
aria-details屬性標識提供與物件相關附加資訊的元素（或元素）。- aria-disabled
aria-disabled狀態表示元素是可感知的但被停用的，因此它不可編輯或無法操作。- aria-dropeffect
全域性
aria-dropeffect屬性指示在將拖動的物件釋放到放置目標上時可以執行哪些功能。- aria-errormessage
物件上的
aria-errormessage屬性標識為該物件提供錯誤訊息的元素。- aria-expanded
aria-expanded屬性設定為元素上，以指示控制元件是展開還是摺疊，以及受控元素是否顯示或隱藏。- aria-flowto
全域性
aria-flowto屬性標識內容備用閱讀順序中的下一個元素（或元素）。這允許輔助技術根據使用者的選擇覆蓋讀取文件源順序的一般預設值。- aria-grabbed
aria-grabbed狀態指示元素在拖放操作中的“已抓取”狀態。- aria-haspopup
aria-haspopup屬性指示可以由設定該屬性的元素觸發的互動式彈出元素的可用性和型別。aria-hidden狀態指示元素是否公開給輔助功能 API。- aria-invalid
aria-invalid狀態指示輸入的值不符合應用程式預期的格式。- aria-keyshortcuts
全域性
aria-keyshortcuts屬性指示作者已實現的鍵盤快捷鍵，以啟用或將焦點賦予元素。- aria-label
aria-label屬性定義一個字串值，用於標記互動式元素。- aria-labelledby
aria-labelledby屬性標識標記其應用到的元素的元素（或元素）。- aria-level
aria-level屬性定義元素在結構中的層次級別。- aria-live
全域性
aria-live屬性指示元素將被更新，並描述使用者代理、輔助技術和使用者可以從活動區域獲得的更新型別。- aria-modal
aria-modal屬性指示元素在顯示時是否為模態。- aria-multiline
aria-multiline屬性指示textbox是否接受多行輸入或僅接受單行輸入。- aria-multiselectable
aria-multiselectable屬性指示使用者是否可以從當前可選擇的子代中選擇多個專案。- aria-orientation
aria-orientation屬性指示元素的方向是水平、垂直還是未知/模稜兩可的。- aria-owns
aria-owns屬性標識元素（或元素），以便在無法使用 DOM 層次結構來表示關係時，定義父元素與其子元素之間的視覺、功能或上下文關係。- aria-placeholder
aria-placeholder屬性定義一個簡短的提示（一個詞或短語），旨在幫助使用者在表單控制元件沒有值時輸入資料。提示可以是示例值或預期格式的簡短描述。- aria-posinset
aria-posinset屬性定義元素在當前 listitems 或 treeitems 集中的編號或位置，當並非所有專案都存在於 DOM 中時。- aria-pressed
aria-pressed屬性指示切換按鈕的當前“按下”狀態。- aria-readonly
aria-readonly屬性指示元素不可編輯，但其他方面可操作。- aria-relevant
在 ARIA 活動區域中使用，全域性
aria-relevant屬性指示當活動區域內的 輔助功能樹 被修改時，使用者代理將觸發哪些通知。- aria-required
aria-required屬性指示在提交表單之前，需要在元素上進行使用者輸入。- aria-roledescription
aria-roledescription屬性為元素的角色定義一個人類可讀的、作者本地化的描述。- aria-rowcount
aria-rowcount屬性定義表、網格或樹狀網格中的總行數。- aria-rowindex
aria-rowindex屬性定義元素相對於表、網格或樹狀網格中總行數的位置。- aria-rowindextext
aria-rowindextext屬性定義aria-rowindex的人類可讀文字替代。- aria-rowspan
aria-rowspan屬性定義表、網格或樹狀網格中單元格或網格單元格所跨越的行數。- aria-selected
aria-selected屬性指示各種小部件的當前“已選擇”狀態。- aria-setsize
aria-setsize屬性定義當前 listitems 或 treeitems 集中的專案數，當集合中並非所有專案都存在於 DOM 中時。- aria-sort
aria-sort屬性指示表或網格中的專案是按升序還是降序排序。- aria-valuemax
aria-valuemax屬性定義範圍小部件允許的最大值。- aria-valuemin
aria-valuemin屬性定義範圍小部件允許的最小值。- aria-valuenow
aria-valuenow屬性定義range小部件的當前值。- aria-valuetext
aria-valuetext屬性為範圍小部件定義aria-valuenow的人類可讀文字替代。