ARIA 角色Explained

77 of 77 rows

角色↕	用途↕	适用场景↕
地标
⤢banner	标识页面顶部的站点页眉。	品牌标志、主标语、页面顶部的报头。
⤢navigation	将一组导航链接归为一组。	主导航菜单、面包屑、页内导航。
⤢main	标记文档的主体内容。	页面唯一的主内容区。
⤢complementary	标记独立于 main 的辅助内容。	侧边栏、相关链接、提示框。
⤢contentinfo	归组关于父文档的页脚元信息。	版权行、隐私链接、法律页脚。
⤢search	标记包含搜索表单的区域。	站内搜索、筛选表单、页内查找框。
⤢region	标记页面中有名称、可感知的区块。	带有可访问名称的自定义区块。
⤢form	标记包含一组表单字段的区域。	有名称的搜索表单、筛选面板、问卷区块。
⤢application	标记行为类似软件应用的区域。	整页编辑器、地图、游戏画面。
文档
⤢article	标记独立成篇的内容。	博客文章、新闻条目、产品卡片。
⤢heading	标记内容区块的标题。	原生 h1-h6 不适用时的区块标题。
⤢list	将一组相关条目归为列表。	自定义的项目符号或编号列表。
⤢listitem	标记列表内的单个条目。	自定义列表中的一行。
⤢group	将一组相关的表单控件归为一组。	表单字段组、单选组、相关输入框。
⤢figure	标记配有说明文字的图形内容。	带标签的图片、示意图、图表。
⤢table	标记按行列排布的数据。	用自定义元素构建的表格数据。
⤢caption	标记表格、网格或图形的可见标签。	数据表格上方的标题、图形标签。
⤢rowgroup	归组表格中一组相关的行。	表格的表头、表体和表尾带。
⤢row	标记表格或网格中的一行单元格。	自定义表格的单条记录行。
⤢columnheader	标记表格列的表头单元格。	数据表格的顶部标签。
⤢rowheader	标记表格行的行头单元格。	每个表格行的首列标签。
⤢cell	标记行内的一个数据单元格。	自定义表格行中的各个值。
⤢term	标记正在被定义的词或短语。	词典词条、定义列表的术语。
⤢definition	标记前述术语的含义。	被定义术语下方的描述。
⤢note	标记位于主内容旁的备注。	提示、旁注、脚注式说明。
⤢directory	标记指向组成员的引用列表。	目录和链接索引（ARIA 1.2 已弃用）。
⤢feed	标记可滚动的文章区块列表。	持续加载更多内容的无限滚动流。
⤢math	标记以数学记号书写的内容。	由 LaTeX 或 MathML 渲染的公式。
⤢meter	标记已知范围内的标量值。	磁盘占用条、分数、强度仪表。
⤢time	标记特定时刻或时长。	时间戳、事件日期、经过时间。
⤢paragraph	标记一段正文文本。	未写成原生 p 元素的文本块。
⤢blockquote	标记引自其他来源的引文。	重点引语和注明出处的摘录。
⤢code	标记一段计算机代码。	行内代码片段和正文中的命令名。
⤢emphasis	标记带语气强调的文本。	句子中被重读的词。
⤢strong	标记具有重要性的文本。	警告、关键短语、必读标签。
⤢subscript	标记渲染在基线以下的文本。	如 H2O 的化学式。
⤢superscript	标记渲染在基线以上的文本。	脚注标记和指数。
⤢generic	标记没有特殊含义的普通容器。	布局包裹器和样式挂钩。
⤢presentation / none	移除元素的语义。	装饰性图片、布局表格、分隔元素。
⤢img	将元素标记为单张图片。	图标雪碧图、SVG 组、CSS 绘制的图形。
小部件
⤢button	标记可点击并触发操作的控件。	自定义按钮、图标按钮、操作触发器。
⤢link	标记指向其他资源或位置的链接。	自定义锚点和应用内路由链接。
⤢checkbox	标记单个选项的切换控件。	自定义复选框、接受条款开关。
⤢radio	标记互斥组中的一个选项。	radiogroup 内的自定义单选钮。
⤢switch	标记二元的开/关切换。	主题、静音和设置开关。
⤢tablist	归组一组标签页的标签。	标签式面板的标签条。
⤢tab	标记 tablist 内的一个标签。	显示一个面板的单个标签页。
⤢tabpanel	标记一个标签页的内容面板。	其标签页处于活动状态时显示的主体。
⤢dialog	标记叠加在页面之上的窗口。	模态框、抽屉、抢占焦点的弹出层。
⤢alertdialog	标记需要用户回应的对话框。	删除确认、未保存更改提示。
⤢combobox	标记带选项弹出层的输入框。	自动补全、搜索选择、预先输入列表。
⤢slider	标记在范围内设定值的控件。	音量、价格、不透明度、范围输入。
⤢menu	标记向用户提供的一组选项列表。	下拉菜单、上下文菜单、工具面板。
⤢menuitem	标记菜单内的单个选项。	下拉菜单的一行或一项。
⤢textbox	标记用于自由文本输入的字段。	自定义输入框、搜索字段、评论框。
⤢tree	标记层次结构的条目列表。	文件浏览器、嵌套菜单、组织架构图。
⤢listbox	标记可选择选项的列表。	单选或多选的自定义选择器。
⤢option	标记 listbox 内的一个选项。	自定义 listbox 中一个可选条目。
⤢radiogroup	归组一组互斥的选项。	自定义单选组、套餐选择、量表答案。
⤢grid	标记由行列单元格组成的部件。	电子表格布局、日历月视图。
⤢treegrid	标记行可展开折叠的网格。	嵌套数据表、邮件会话表。
⤢treeitem	标记树内一个可展开的选项。	文件浏览器中的文件或文件夹节点。
⤢tooltip	标记为控件提供提示的弹出层。	悬停提示、图标按钮的焦点提示。
⤢progressbar	标记显示任务进度的元素。	上传条和加载指示器。
⤢scrollbar	标记滚动内容视图的控件。	窗格和轮播的自定义滚动条。
⤢spinbutton	标记按步长更改数值的控件。	数量选择器、数字步进器。
⤢searchbox	标记输入搜索词的文本字段。	自定义搜索栏和筛选字段。
⤢toolbar	标记一组常用控件。	格式化栏、编辑器上方的操作行。
⤢menubar	标记一排常驻的菜单触发器。	应用式的“文件”和“编辑”菜单条。
⤢menuitemcheckbox	标记可开关的菜单选项。	下拉菜单中的视图选项开关。
⤢menuitemradio	标记菜单内一个互斥选项。	菜单中的排序和主题选择。
⤢separator	标记内容组之间的分隔符。	菜单分隔线、可拖动的窗格分隔条。
实时区域
⤢alert	播报时间敏感的重要消息。	表单错误、需要立即关注的紧急通知。
⤢status	不打断地播报提示性更新。	保存确认、进度、温和的结果。
⤢log	播报按时间排列的流中的新条目。	聊天记录、事件日志、活动流。
⤢marquee	播报滚动或移动的文本内容。	跑马灯、滚动新闻条、轮换横幅。
⤢timer	播报实时计时器或倒计时。	会话超时、倒计时、秒表。