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的人类可读文本替代。