ARIA 状态和属性（attributes）
本页列出了涵盖 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 上描述的 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: 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-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的人类可读文本替代。