WAI-ARIA无障碍网页应用属性完全展示

2014 年 8 月 13 日

一、你至少应该知道ARIA是什么东西！

WAI-ARIA指无障碍网页应用。主要针对的是视觉缺陷，失聪，行动不便的残疾人以及假装残疾的测试人员。尤其像盲人，眼睛看不到，其浏览网页则需要借助辅助设备，如屏幕阅读器，屏幕阅读机可以大声朗读或者输出盲文。

而ARIA就是可以让屏幕阅读器准确识别网页中的内容，变化，状态的技术规范，可以让盲人这类用户也能无障碍阅读！

二、为什么需要ARIA？

回答标题问题前我先问其他几个问题？

如何让盲人用户知道当前浏览区域就是网站主导航？
如果让盲人用户知道点击某个按钮后出来的是弹框？
如何让盲人用户知道点击某个按钮后页面另外一个区域的文字发生了变化？
如何让盲人用户知道您使用了li标签是用来模拟标准select控件呢？
如何让盲人用户知道您模拟的select控件是单选呢还是可以多选呢？

在你现有的知识范围内，您有办法解决上面的问题吗？有人会说，我使用HTML5, 恩，确实，HTML5的出现大大增强了网页的可访问性和无障碍阅读，但是，其不是万能的，例如无法让盲人知道模拟控件的类型等。

因此，才需要ARIA.

三、ARIA是个非主流，咱不鸟！

ARIA是非主流吗？真是睡在冻床上不知冷热啊。ARIA规范一直在更新维护，浏览器方面IE8+以及其他所有现代浏览器都都已支持ARIA, 几乎可以说是全方位支持。流行的JavaScript库jQuery, 以及衍生的jQuery Mobile早早支持了ARIA，国内知名JavaScript库kissy也在去年（我没记错的话）支持了ARIA并在实际项目中使用了（可以在淘宝首页寻觅踪迹）。

Coach是包包中的主流吗？ARIA就是包包中的Coach.

四、算了吧，盲人，这么小众，鸟个毛啊！

嘛，确实，反正你一辈子就照着设计图切几个死页面就够了。

五、靠，ARIA相关属性茫茫多，老子调戏前台都没时间，鸟这个！

ARIA相关属性虽然多，哥们，要晓得，时间紧的时候，做前戏就没有必要把每个部位都亲个遍，直接针对敏感部位就行了。ARIA也是一样，知道几个常用的属性就可以了。以后在领导面前吹嘘啊，面试得瑟啊什么的就有料了！

到现在全是文字，为了提高可阅读性，避免文字阅读吃力的潜在用户关闭本页面，是时候举个实际的例子提提大家的神了，让大家知道ARIA就是个冰激凌（跟屎放在一起只是肤色白了点而已）。

本例来自淘宝首页，大家有兴趣也可以自己看看，示例对象见下截图（淘宝网右上角选项卡）：
淘宝网首页右上角选项卡张鑫旭-鑫空间-鑫生活

使用firebug查看其对应的HTML代码，就可以看到aria的应用啦！
淘宝网首页aria无障碍阅读选项卡HTML代码张鑫旭-鑫空间-鑫生活

仔细一看，唷，这可是标准的选项卡ARIA属性应用（该用的属性都有），OK，对于常用的选项卡，就套用淘宝网这里的结构吧，很标准的。就是增加几个role属性，增加几个aria-属性就可以了，然后，这个选项卡就变成了很牛逼很碉堡的无障碍阅读选项卡啦。恩，这再一次验证了这个道理：要变成牛人很简单——骑在牛身上就可以了。

哎呀哎呀，聪明好学的你可能希望知道这里aria-hidden, aria-labelledby是啥意思。

好同学，我被你这种学习的热情感动了，于是决把我这几天没日没夜整理的WAI-ARIA无障碍网页应用属性大全表展示出来，上面的两个属性，以及其他N多aria-的兄弟姐妹属性都可以从下面几个表中找到。

如果你被表格的高度吓住了不想看也没关系，记住这里，回头需要的时候再来找找，哦呵呵！^_^

下面三个表，依次为：ARIA role属性值表、ARIA属性表、ARIA状态属性表。

六、ARIA属性表

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">黄小仙

同样，大家都懂的，没啥好说的
aria role=checkbox

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月

例如时间选择器中的月份标题：
aria时间选择器

listbox

表示列表框


      
role="listbox" aria-expanded="true">
    晴川
    静秋
    黄小仙

log

表示日志记录

role="log" aria-atomic="false" aria-relevant="additions">

类似三国杀右侧记录战事区域；或是比赛文字直播记录区域。

表示菜单


  美女
    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显示的就是当前滑动位置对应的值。
aria 自定义滑动条 » 张鑫旭-鑫空间-鑫生活

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的效果图：
aria单选

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像素水平分隔线：
aria菜单分隔线

slider

表示滑动条


    role="slider" src="slider_control.png" />
    45

spinbutton

表示微调

role="spinbutton"
    aria-valuemin="0" aria-valuemax="100" aria-valuenow="50" tabindex="0">
50

例如下面这个数值微调效果截图：
aria数值微调

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">
      淑女

如果您看到下面的文字，可能是由于在其他网站或是RSS中阅读本文，本文原地址：http://www.zhangxinxu.com/wordpress/?p=2277，本文作者：张鑫旭，来自张鑫旭-鑫空间-鑫生活，访问原出处更多精彩内容。

属性名属性值 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焦点获取状态。

注意：为了跨浏览器兼容，总是使用WAI-ARIA属性解析来访问和修改ARIA属性，例如object.setAttribute("aria-valuenow", newValue).

七、附图

末了，附上09年，腾讯（好像现在叫isux）团队弄的张ARIA相关大图：

点击图片查看大图

八、对提供资源便于整理的站点的感谢

感谢http://msdn.microsoft.com, 感谢Chromium官方的扩展开发文档，感谢openajax可访问性官方网站，感谢opera提供的ARIA文档，感谢W3C编辑者草案，感谢百度，必应，谷歌的搜索支持。

最最重要的，就是感谢大家的支持，正因为有你们或言语或财力上的支持，我才能坚持下来，完成这么多内容的整理!

最后，我由衷希望本文内容能够对国内无障碍网页应用的重视和发展提供一些帮助。

辛苦之作，尊重劳动，转载请注明来自张鑫旭-鑫空间-鑫生活[http://www.zhangxinxu.com]
本文地址：http://www.zhangxinxu.com/wordpress/?p=2277

About The Author

bjmayor

程序员，码农，php,python,ios,android,go，产品经理，创业。

M	T	W	T	F	S	S
« Jan
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30

一、你至少应该知道ARIA是什么东西！

二、为什么需要ARIA？

三、ARIA是个非主流，咱不鸟！

四、算了吧，盲人，这么小众，鸟个毛啊！

五、靠，ARIA相关属性茫茫多，老子调戏前台都没时间，鸟这个！

六、ARIA属性表

美女们：

美女们：

aria-controls="panel1" aria-expanded="true" role="tab" tabindex="0">姑娘们

请选择你中意的美女……

次标题

aria-expanded="true" role="tab" tabindex="0">姑娘们

请选择你中意的：

七、附图

八、对提供资源便于整理的站点的感谢

Related Posts

About The Author

bjmayor