aria属性表

六、ARIA属性表

ARIA Roles值示意及说明表

role属性值	含义	HTML示意	说明
alert	表示警告	role="alert">	例如ajax操作返回错误信息的div标签。
alertdialog	表示警告弹出框	role="alertdialog" id="alert1"> 弹出框 哥，你输入的时间穿越了，请重新输入！	自定义的出错提示弹框。
application	表示应用	role="application"> 时间: 选择日期... <-- 时间选择控件具体 -->	例如自定义的时间选择器。
button	表示按钮	role="button" alt="cut" /> role="button" alt="copy" /> role="button" alt="paste" />	大家都懂的，没啥好说的
checkbox	表示复选框	role="checkbox" aria-checked="mixed" tabindex="0">所有姑娘 role="checkbox" aria-checked="false" tabindex="0">晴川 role="checkbox" aria-checked="true" tabindex="0">静秋 role="checkbox" aria-checked="true" tabindex="0">黄小仙	同样，大家都懂的，没啥好说的
combobox	表示下拉列表框	role="combobox" aria-autocomplete="inline" aria-owns="cb1-list" /> 晴川 静秋 黄小仙
grid	表示网格	role="grid" aria-labelledby="grid1_label" aria-readonly="true"> 美女们 晴川 静秋 黄小仙
gridcell	表示网格单元	role="gridcell" tabindex="-1">晴川 role="gridcell" tabindex="-1">静秋 role="gridcell" tabindex="-1">黄小仙	类似于table & table-cell
group	表示组合并	role="group"> 所有姑娘 晴川 静秋 黄小仙
heading	表示应用程序标题头	role="heading" aria-live="assertive" aria-atomic="true">2012年 3月	例如时间选择器中的月份标题：
listbox	表示列表框	role="listbox" aria-expanded="true"> 晴川 静秋 黄小仙
log	表示日志记录	role="log" aria-atomic="false" aria-relevant="additions">	类似三国杀右侧记录战事区域；或是比赛文字直播记录区域。
menu	表示菜单	美女 role="menu" aria-hidden="true"> 晴川 静秋 黄小仙 靓女 淑女 熟女
menubar	表示菜单栏	role="menubar" title="美女菜单"> 美女 晴川 静秋 黄小仙 靓女 淑女 熟女
menuitem	表示菜单项	role="menuitem" tabindex="0" aria-haspopup="true">美女 晴川 静秋 黄小仙 role="menuitem" tabindex="-1" aria-haspopup="false">靓女 role="menuitem" tabindex="-1" aria-haspopup="false">淑女 role="menuitem" tabindex="-1" aria-haspopup="false">熟女
menuitemcheckbox	表示可复选的菜单项	美女 role="menuitemcheckbox" tabindex="-1" aria-checked="true">晴川 role="menuitemcheckbox" tabindex="-1" aria-checked="true">静秋 role="menuitemcheckbox" tabindex="-1" aria-checked="false">黄小仙 靓女 淑女 熟女
menuitemradio	表示只能单选的菜单项	美女 role="menuitemradio" tabindex="-1" aria-checked="true">晴川 role="menuitemradio" tabindex="-1" aria-checked="false">静秋 role="menuitemradio" tabindex="-1" aria-checked="false">黄小仙 靓女 淑女 熟女
option	表示选项	role="option">晴川 role="option">静秋 role="option">黄小仙
presentation	表示称述	role="presentation" tabindex="0">45	左边示例的HTML为一个自定义的滑动条。而role="presentation"所在div显示的就是当前滑动位置对应的值。
progressbar	表示进度条	role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" tabindex="0"> 23%
radio	表示单选	美女们： role="radio" aria-checked="false"> 晴川 role="radio" aria-checked="true"> 静秋 role="radio" aria-checked="false"> 黄小仙	自定义单选框控件的时候使用，下图为左侧HTML的效果图：
radiogroup	表示单选组	美女们： role="radiogroup" aria-labelledby="girl_label"> 晴川 静秋 黄小仙
region	表示区域	role="region" tabindex="-1" aria-expanded="false"> 我之所以会出现，是因为主人你点击了某个命中注定的按钮。	例如用在div区域显示隐藏切换的时候。
row	表示行	role="row" aria-selected="false"> 晴川 静秋 黄小仙	用在表格模拟的行列表上，对应table下面的tr标签。
separator	表示分隔	美女 晴川 role="separator" tabindex="-1"> 静秋 黄小仙 靓女 淑女 熟女	反应在下图就是那条黑色的1像素水平分隔线：
slider	表示滑动条	role="slider" src="slider_control.png" /> 45
spinbutton	表示微调	role="spinbutton" aria-valuemin="0" aria-valuemax="100" aria-valuenow="50" tabindex="0"> 50	例如下面这个数值微调效果截图：
tab	表示标签	role="tab" tabindex="0">美女 role="tab" aria-selected="false" tabindex="-1">淑女 role="tab" aria-selected="false" tabindex="-1">熟女 role="tab" aria-selected="false" tabindex="-1">腐女
tablist	表示标签列表	role="tablist"> 美女 淑女 熟女 腐女
tabpanel	表示标签面板	role="tabpanel"> <-- 选项卡 --> role="tabpanel"> 晴川 静秋 黄小仙 role="tabpanel"> role="tabpanel"> role="tabpanel">
timer	表示计数	role="timer" aria-atomic="true" aria-relevant="all">0	模拟计数器，使用在动态显示规律数值变化的地方
toolbar	表示工具栏	role="toolbar" tabindex="0" aria-activedescendant="button1">	左边HTML表示一个剪切，复制，粘贴三功能在一起的工具栏。
tooltip	表示提示文本	姓名: role="tooltip" aria-hidden="true">必须是美女姓名哦~~	如下图黄色的这个提示框：
tree	表示树形	role="tree"> 美女 淑女	效果见下面treeitem中的图。
treeitem	表示树结构选项	role="treeitem"> 美女 role="treeitem">晴川 role="treeitem">静秋 role="treeitem">黄小仙 role="treeitem"> 淑女

 

ARIA 属性值示意及说明表

属性名	属性值	HTML示意	说明
aria-activedescendant	字符串。表示后代元素的id值。	aria-activedescendant="button1">	aria-activedescendant 属性定义了当工具栏获取焦点时，哪一个工具栏的子控件获取了焦点。在此HTML示例中，工具栏的第一个控件（拥有id “button1″）是能获取焦点的子控件。
aria-atomic	字符串。表示区域内容是否完整播报。值可以为true和false。当为true时，表示辅助设备需要把整个区域内容都通报给使用者；如果为false则表示只需要通报修改的部分。	aria-atomic="true">2012年 3月	还是这个时间选择器年月标题的例子。这里的aria-atomic为true则表示当时间改变的时候，这里的年月日期要完整播放，不要只改了月份就只报月份内容。
aria-autocomplete	字符串。表示用户的文本框的自动提示是否提供。可选值有：inline, list, both, none.	aria-autocomplete="inline" aria-owns="list" /> 晴川 静秋 黄小仙	目前，该属性对于inline和list两个值的含义暂不清楚。不过可以确定的是该属性对应HTML5中autocomplete属性。需要注意的是，如果aria-autocomplete="list", aria-autocomplete="inline"或aria-autocomplete="both"被设置在支持autocomplete的元素上，则autocomplete的属性值需要设成"on", 如果是aria-autocomplete="none"，则需要设成"off"
aria-busy	字符串。表当前区域的忙碌状态。默认为false, 表清除busy状态；可选为true, 表该区域正在加载；或为error, 表示该区域验证无效。	aria-busy="true" aria-live="polite">	如果某个区域内(如这里ul)有多个地方需要修改，需要全部修改完毕再通知使用者的话，就可以先将aria-busy设为true, 等到全部内容更新完毕后再设成false. 该属性可以避免辅助工具在区域内容更新完毕前不断即时提醒使用者。
aria-controls	字符串。空格分隔的id属性值列表。	aria-controls="panel1" aria-expanded="true" role="tab" tabindex="0">姑娘们 请选择你中意的美女……	该属性定义了元素间不能通过文档结构决定的关联关系。ariaControls属性主要被role为group, region, 或widget的元素使用。
aria-describedby	字符串。空格分隔的id属性值列表。	所有姑娘 aria-describedby="desc1" tabindex="0">晴川 杨幂饰演的穿越女王~~	同样的，该属性定义了文档结构表现不出来的的元素间的相互关联性。该属性旨在通过标签提供更多用户可能需要的信息。如果指定了不只一个id, 所有元素会合并在一起共同创建一条单独的描述。
aria-dropeffect	字符串。表示拖拽效果。可选值有：copy, move, reference, execute, popup, none, 依次表示：复制，移动，参照，执行，弹出以及没有效果。	<-- 暂无HTML示例 -->	该属性用在拖拽上。
aria-flowto	字符串。空格分隔的id值们。	<-- 暂无HTML示例 -->	如果该属性值对应的是单独的id, 辅助技术会恢复目标元素的阅读；如果对应的是多个id, 则辅助技术会让用户去选择、导航到目标元素。
aria-grabbed	字符串。拖拽中元素的捕获状态。可选值有:true, false, undefined. 默认为undefined，表示元素捕获状态未知。true表示元素可以捕获；false表示不能被捕获。	<-- 暂无HTML示例 -->	该属性用在拖拽上。类似于HTML5中的draggable属性。
aria-haspopup	字符串。true表示点击的时候会出现菜单或是浮动元素； false表示没有pop-up效果。	aria-haspopup="true"> 美女 晴川 静秋 黄小仙 aria-haspopup="false">靓女 aria-haspopup="false">淑女 aria-haspopup="false">熟女
aria-label	字符串。	<-- 暂无HTML示例 -->	定义一个字符串值标记当前元素。
aria-labelledby	字符串。空格分隔的id们	标题	aria-labelledby一般用在区域元素上，对于的id一般为对应的标题或是标签元素的id.关系型属性。
aria-level	数值。表示等级。	次标题	上面的HTML类似于 次标题
aria-live	字符串。可选值有：off, polite, assertive, rude。默认为off, 表示不宣布更新；polite表示只有用户闲时宣布；assertive表示尽快对用户宣布；rude表示即时提醒用户，必要的时候甚至中断用户。	aria-live="assertive" aria-atomic="true">2012年 3月	绝大多数的更新应该在用户闲暇的时候告知，即时提示对用户是一种干扰。如果希望内容完全更新后再提示，可以使用上面提到的aria-busy. 左侧的HTML为时间选择控件的年月标题部分，aria-live="assertive"表示的是当用户选择了新的时间的时候，尽快通知用户时间发生了变更。
aria-multiselectable	字符串。表示是否可多选。默认为false, 表示一次只能选择一个项。true表示一次可以选择多个项。	<-- 暂无HTML示例 -->	例如手风琴展开收起效果，我们可以使用aria-multiselectable来告知辅助设备，一次可以展开多个项还是只有一个展开。
aria-owns	字符串。值为目标元素id.	aria-owns="list" /> 晴川 静秋 黄小仙	aria-owns表示元素所拥有的，这里这里的文本框拥有其对应的下拉列表。
aria-posinset	数值。表示当前位置。	<-- 暂无HTML示例 -->	用在设置和获取一个集合内某项的当前位置。
aria-readonly	字符串。表示是否只读。默认为false, 表示元素值可以被修改；true表示元素指不能被改变。	aria-readonly="true"> 美女们 晴川 静秋 黄小仙
aria-relevant	字符串。表示区域内哪些操作行为需要做出反应。可选值有：additions, removals, text, all，可以空格分隔多个一起显示. additions表示新增节点的时候做出反应；removals表示删除节点时重要操作；text表示文本改变是值得重视的；all等同于同时使用上面三个属性值。	aria-relevant="additions">	左边的HTML表示当日志内容有添加的时候做出反应。
aria-required	字符串。元素值是否必需。默认为false, 表示元素值可以为空；true表示元素值是必需的。	* 姓名: aria-required="true" /> 姓名不能为空	多半用在表单控件中。对应HTML5中required属性。
aria-secret	字符串。表示机密状态。	<-- 暂无HTML示例 -->	具体含义不详
aria-setsize	数值。设置的尺寸大小值。	<-- 暂无HTML示例 -->	顾名思意
aria-sort	字符串。表示表格或格栅中的项是以升序排列还是降序排列。可选值：ascending(↑), descending(↓), none, other.	<-- 暂无HTML示例 -->	Widget组件应用属性。
aria-valuemax	数值。表允许的最大值。	aria-valuemax="100" aria-valuemin="0" role="slider" src="slider_control.png" /> 45	用在范围组件上。对应于HTML5中的max属性。
aria-valuemin	数值。表示允许的最小值。	aria-valuemin="0" role="slider" src="slider_control.png" /> 45	用在范围组件上。对应于HTML5中的min属性。
aria-valuenow	数值。表示当前值。	aria-valuenow="45" aria-valuemax="100" aria-valuemin="0" role="slider" src="slider_control.png" /> 45	用在范围组件上。对应于value属性。
aria-valuetext	字符串。定义等同于aria-valuenow人可读的文本。	<-- 暂无HTML示例 -->	用在范围组件上。

 

ARIA 状态值示意及说明表

属性状态	属性值	HTML示意	说明
aria-checked	字符串。表示检查的状态。true表示元素被选择；false表示元素未被选择；mixed表示元素同时有选择和为选择状态。	aria-checked="mixed" tabindex="0">所有姑娘 aria-checked="false" tabindex="0">晴川 aria-checked="true" tabindex="0">静秋 aria-checked="true" tabindex="0">黄小仙	该属性用来表明用户是否选择了某些项（如左边这个截图所示）。
aria-disabled	字符串。表禁用状态，true表示当前是非激活状态；false表示清除非激活状态。	aria-disabled="false">添加	对应单复选框等控件的disabled属性，一般用在自定义模拟控件中。
aria-expanded	字符串。表示展开状态。默认为undefined, 表示当前展开状态未知。其它可选值：true表示元素是展开的；false表示元素不是展开的。	aria-expanded="true" role="tab" tabindex="0">姑娘们 请选择你中意的： 晴川 静秋 黄小仙	例如在手风琴交互效果中标示展开与否的状态。该属性对应HTML5的open属性。
aria-hidden	字符串。可选值为true和false, true表示元素隐藏(不可见)，false表示元素可见。	23%	该属性使用非常普遍。几乎所有涉及到显示与隐藏这类交互或没有交互的地方都可以应用该属性。左边的示例HTML代码来自进度条进度值显示的div, 当前aria-hidden为false, 表示该进度值是可见的。
aria-invalid	字符串。表示元素值是否错误的。默认为false, 表示是OK的，如果为true, 则表示值验证不通过。	aria-invalid="false" />
aria-pressed	字符串。表示按下的状态，可选值有：true, false, mixed, undfined.默认为undfined, 表示按下状态未知；true表示元素往下（按钮按下）；false表示元素抬起；mixed表示元素同时有按下和没有按下的状态。	aria-pressed="false" aria-disabled="false">添加	左边HTML表示按钮已经按下，同时处于禁用状态。
aria-selected	字符串。表示选择状态。可选值有：true, false, undefined. 默认为undefined，表示元素选择状态未知。true表示元素已选择；false表示未被选中。	aria-selected="true" tabindex="0">美女 aria-selected="false" tabindex="-1">淑女 aria-selected="false" tabindex="-1">熟女 aria-selected="false" tabindex="-1">腐女	元素被选中表明其处于某种交互之中，因此选中元素很可能处于focus焦点获取状态。