六、ARIA属性表
ARIA Roles值示意及说明表
role属性值
含义
HTML示意
说明
alert
表示警告
例如ajax操作返回错误信息的div
标签。
alertdialog
表示警告弹出框
自定义的出错提示弹框。
application
表示应用
例如自定义的时间选择器。
button
表示按钮
大家都懂的,没啥好说的
checkbox
表示复选框
同样,大家都懂的,没啥好说的
combobox
表示下拉列表框
grid表示网格
gridcell表示网格单元
类似于table & table-cellgroup表示组合并
heading表示应用程序标题头
2012年 3月
例如时间选择器中的月份标题:
listbox表示列表框
role=“combobox” aria-autocomplete=“inline” aria-owns=“cb1-list” />
log表示日志记录
类似三国杀右侧记录战事区域;或是比赛文字直播记录区域。menu表示菜单
menubar表示菜单栏
menuitem表示菜单项
menuitemcheckbox表示可复选的菜单项
menuitemradio表示只能单选的菜单项
option表示选项
role=“combobox” aria-autocomplete=“inline” aria-owns=“cb1-list” />
presentation表示称述
role=“slider” src=“slider_control.png” />
45
左边示例的HTML为一个自定义的滑动条。而
role=“presentation"
所在
div
显示的就是当前滑动位置对应的值。
progressbar表示进度条
aria-valuenow=“0” aria-valuemin=“0” aria-valuemax=“100” tabindex=“0”>
23%
radio表示单选
美女们:
自定义单选框控件的时候使用,下图为左侧HTML的效果图:
radiogroup表示单选组
美女们:
region表示区域
我之所以会出现,是因为主人你点击了某个命中注定的按钮。
例如用在
div
区域显示隐藏切换的时候。row表示行
用在表格模拟的行列表上,对应
table
下面的
tr
标签。separator表示分隔
反应在下图就是那条黑色的1像素水平分隔线:
slider表示滑动条
role=“slider” src=“slider_control.png” />
45
spinbutton表示微调
aria-valuemin=“0” aria-valuemax=“100” aria-valuenow=“50” tabindex=“0”>
50
例如下面这个数值微调效果截图:
tab表示标签
tablist表示标签列表
tabpanel表示标签面板
timer表示计数
0
模拟计数器,使用在动态显示规律数值变化的地方toolbar表示工具栏
左边HTML表示一个剪切,复制,粘贴三功能在一起的工具栏。tooltip表示提示文本
如下图黄色的这个提示框:
tree表示树形
美女
淑女
效果见下面
treeitem
中的图。treeitem表示树结构选项
美女
淑女
目前,该属性对于
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
, 表示该区域验证无效。
如果某个区域内(如这里
ul
)有多个地方需要修改,需要全部修改完毕再通知使用者的话,就可以先将
aria-busy
设为
true
, 等到全部内容更新完毕后再设成
false
. 该属性可以避免辅助工具在区域内容更新完毕前不断即时提醒使用者。aria-controls字符串。空格分隔的
id
属性值列表。
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-label字符串。
<-- 暂无HTML示例 --> 定义一个字符串值标记当前元素。aria-labelledby字符串。空格分隔的
id
们
标题
aria-labelledby
一般用在区域元素上,对于的
id
一般为对应的标题或是标签元素的
id
.关系型属性。aria-level数值。表示等级。
次标题
上面的HTML类似于
次标题
aria-live字符串。可选值有:
off
,
polite
,
assertive
,
rude
。默认为
off
, 表示不宣布更新;
polite
表示只有用户闲时宣布;
assertive
表示尽快对用户宣布;
rude
表示即时提醒用户,必要的时候甚至中断用户。
2012年 3月
绝大多数的更新应该在用户闲暇的时候告知,即时提示对用户是一种干扰。如果希望内容完全更新后再提示,可以使用上面提到的
aria-busy
.
左侧的HTML为时间选择控件的年月标题部分,aria-live="assertive"
表示的是当用户选择了新的时间的时候,尽快通知用户时间发生了变更。
aria-multiselectable字符串。表示是否可多选。默认为
false
, 表示一次只能选择一个项。
true
表示一次可以选择多个项。
<-- 暂无HTML示例 --> 例如手风琴展开收起效果,我们可以使用
aria-multiselectable
来告知辅助设备,一次可以展开多个项还是只有一个展开。aria-owns字符串。值为目标元素
id
.
role=“combobox” aria-autocomplete=“inline” aria-owns=“list” />
aria-owns
表示元素所拥有的,这里这里的文本框拥有其对应的下拉列表。
aria-posinset数值。表示当前位置。
<-- 暂无HTML示例 --> 用在设置和获取一个集合内某项的当前位置。aria-readonly字符串。表示是否只读。默认为
false
, 表示元素值可以被修改;
true
表示元素指不能被改变。
aria-relevant字符串。表示区域内哪些操作行为需要做出反应。可选值有:
additions
,
removals
,
text
,
all
,可以空格分隔多个一起显示.
additions
表示新增节点的时候做出反应;
removals
表示删除节点时重要操作;
text
表示文本改变是值得重视的;
all
等同于同时使用上面三个属性值。
左边的HTML表示当日志内容有添加的时候做出反应。aria-required字符串。元素值是否必需。默认为
false
, 表示元素值可以为空;
true
表示元素值是必需的。
多半用在表单控件中。对应HTML5中
required
属性。aria-secret字符串。表示机密状态。
<-- 暂无HTML示例 --> 具体含义不详aria-setsize数值。设置的尺寸大小值。
<-- 暂无HTML示例 --> 顾名思意aria-sort字符串。表示表格或格栅中的项是以升序排列还是降序排列。可选值:
ascending
(↑),
descending
(↓),
none
,
other
.
<-- 暂无HTML示例 --> Widget组件应用属性。aria-valuemax数值。表允许的最大值。
role=“slider” src=“slider_control.png” />
45
用在范围组件上。对应于HTML5中的
max
属性。aria-valuemin数值。表示允许的最小值。
role=“slider” src=“slider_control.png” />
45
用在范围组件上。对应于HTML5中的
min
属性。aria-valuenow数值。表示当前值。
role=“slider” src=“slider_control.png” />
45
用在范围组件上。对应于
value
属性。aria-valuetext字符串。定义等同于
aria-valuenow
人可读的文本。
<-- 暂无HTML示例 --> 用在范围组件上。
ARIA 状态值示意及说明表
属性状态
属性值
HTML示意
说明
aria-checked
字符串。表示检查的状态。true
表示元素被选择;false
表示元素未被选择;mixed
表示元素同时有选择和为选择状态。
该属性用来表明用户是否选择了某些项(如左边这个截图所示)。
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-pressed字符串。表示按下的状态,可选值有:
true
,
false
,
mixed
,
undfined
.默认为
undfined
, 表示按下状态未知;
true
表示元素往下(按钮按下);
false
表示元素抬起;
mixed
表示元素同时有按下和没有按下的状态。
aria-disabled=“false”>添加
左边HTML表示按钮已经按下,同时处于禁用状态。aria-selected字符串。表示选择状态。可选值有:
true
,
false
,
undefined
. 默认为
undefined
,表示元素选择状态未知。
true
表示元素已选择;
false
表示未被选中。
元素被选中表明其处于某种交互之中,因此选中元素很可能处于focus焦点获取状态。