ARIA 状态及属性
这个页面列出了 MDN 上讨论的所有 WAI-ARIA 属性的参考页面。
ARIA 属性用于修改无障碍树中定义的元素的状态和属性。
备注: ARIA 仅用于修改无障碍树,进而改变辅助技术向用户呈现内容的方式。ARIA 不会改变元素的功能或行为。当使用非语义化的 HTML 元素来实现其他功能时,你必须使用 JavaScript 来控制元素的实际行为、焦点以及 ARIA 状态。
ARIA 特性类别
ARIA 的状态和属性(合称为“特性”)共有 4 类:
-
小部件(widget)特性
aria-autocomplete
aria-checked
aria-disabled
aria-errormessage
aria-expanded
aria-haspopup
aria-hidden
aria-invalid
aria-label
aria-level
aria-modal
aria-multiline
aria-multiselectable
aria-orientation
aria-placeholder
aria-pressed
aria-readonly
aria-required
aria-selected
aria-sort
aria-valuemax
aria-valuemin
aria-valuenow
aria-valuetext
-
活动区域特性
-
拖放特性
-
关系特性
全局 ARIA 特性
无论是否应用了 ARIA 角色,某些状态和属性始终适用于所有的 HTML 元素。它们被定义为“全局”特性。所有角色和基本标记元素都支持全局状态和属性。
上面所列出的许多特性都是全局的,这意味着除非被“特别禁止”,它们可以被包含在任意的元素中:
aria-atomic
aria-busy
aria-controls
aria-current
aria-describedby
aria-description
aria-details
aria-disabled
aria-dropeffect
aria-errormessage
aria-flowto
aria-grabbed
aria-haspopup
aria-hidden
aria-invalid
aria-keyshortcuts
aria-label
aria-labelledby
aria-live
aria-owns
aria-relevant
aria-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
属性定义了当所有列都不在 DOM 中时,在table
、grid
或treegrid
中的列总数。- aria-colindex
aria-colindex
属性定义了元素相对于table
、grid
或treegrid
中总列数的列索引或位置。- aria-colindextext
aria-colindextext
属性定义了数字aria-colindex
的可读文本替代。- aria-colspan
aria-hidden
状态指示元素是否暴露给无障碍 API。- aria-label
aria-label
属性定义了一个字符串值,用于为交互元素提供标签。- aria-labelledby
aria-labelledby
属性标识用作应用到当前元素的标签的元素。