一次上线前的验收,产品经理临时提议「只用键盘走一遍」。结果在登录页就卡住了:按 Tab 键,焦点没有任何可见变化,因为设计稿要求「不要那个难看的蓝框」,开发就把 outline 设成了 none。再往后,自定义的下拉选择器按回车没反应,日期选择器也打不开。页面用鼠标点一切正常,但键盘用户走到第二步就走不下去了。

可访问性不是给「少数人」做的慈善,它覆盖的情形比想象中广:键盘用户、读屏软件用户、色觉障碍用户、在强光下看屏幕的人、临时手受伤的人。这篇只讲最基础的四件事:键盘能不能用、焦点看不看得见、语义和 ARIA 怎么配合、对比度够不够。

先建立一个判断标准:不用鼠标能不能走完

可访问性入门不需要背规范,先做一次最简单的测试:把鼠标拔了,只用 Tab、Shift+Tab、回车、空格、方向键,试着完成页面的主要任务。能走完,说明基础结构没有大问题;走不完,卡在哪一步,那里就是问题所在。这个测试十分钟就能做,比读十篇规范更有用。

最常见的卡点有三类:链接和按钮根本拿不到焦点;拿到了焦点但看不见在哪;看得见焦点,但按回车或空格没反应。下面分别说。

测试时还要留意一个容易被忽略的细节:焦点顺序和视觉顺序是否一致。用 CSS 的 order 或绝对定位把元素挪了位置,DOM 顺序却没变,键盘用户就会在页面上来回跳。读屏软件按 DOM 读,视觉用户按位置看,两者不一致时,总有一方会被绕晕。

键盘可达:原生控件已经帮你做好了大半

a、button、input、select、textarea 这些原生控件天然可以被 Tab 选中,也天然响应键盘操作。你自己用 div 拼一个按钮,这些行为一个都没有,得手动补:tabindex="0" 让它能聚焦,role="button" 让读屏软件知道它是什么,再监听 Enter 和空格键触发点击。三件事里漏一件,体验就不完整。

能用原生标签就用原生标签。一个 button 加 CSS 可以做成任何形状,圆角、渐变、图标都能改,没有任何理由用 div 重新实现一遍。这条经验能省掉大量无障碍补丁,也能省掉后续每个新组件重复补丁的成本。

tabindex 的取值:只用 0 和 -1

tabindex 控制元素能不能被 Tab 选中。实际项目里只需要记住两个值:

  • tabindex="0":把元素加进自然的 Tab 顺序,顺序由它在 DOM 里的位置决定。给自定义控件补焦点能力时用。
  • tabindex="-1":能用脚本 focus() 聚焦,但 Tab 键不会停在它上面。用于「跳到错误提示」「打开弹窗后把焦点移进去」这类场景。

不要用正整数,比如 tabindex="3"。它会把元素提到 Tab 顺序的绝对位置,和 DOM 顺序打架,页面一复杂就没人能预测下一跳去哪。这个坑很隐蔽:单看某个组件没问题,组合起来顺序全乱,而且新增一个元素就可能要重排全站的正整数。

跳转链接:让键盘用户绕过导航

站点顶部通常有一排导航,键盘用户每次进页面都要按好几次 Tab 才能到正文。解决办法是在 body 最前面放一个「跳到主要内容」的链接,平时藏在屏幕外,聚焦时出现,指向 main 的 id。这个模式很成熟,成本也就十几行代码,收益是每次访问都省下若干次按键。

<a class="skip-link" href="#main">跳到主要内容</a>
...
<main id="main">...</main>

跳转链接必须是页面里第一个可聚焦的元素,且聚焦时真的可见。如果它一直被 display: none 藏着,或者被其他浮动层盖住,键盘用户根本用不到。判断方法很简单:打开页面按第一下 Tab,看出现的是不是它。

焦点:可以换样式,但不能让用户找不到

浏览器默认给聚焦元素画一圈轮廓,设计师常觉得难看,于是全局写 *:focus { outline: none }。这一刀下去,鼠标用户没感觉,键盘用户直接失去方向。正确做法是「换一种看得见的方式」,而不是删掉。

现在更推荐用 :focus-visible:它只在「浏览器认为用户需要看到焦点」时生效,典型情况是键盘操作;鼠标点击按钮时通常不显示。这样既照顾了设计,也保住了键盘体验。不过 :focus-visible 的支持情况随浏览器版本变化,老版本可能不认,实际项目里可以保留一个普通的 :focus 样式作为兜底。

.card a:focus-visible {
  outline: 2px solid #2f6f4e;
  outline-offset: 2px;
}

焦点样式要满足两个条件:看得清、和不聚焦时有明显区别。只把颜色微微加深一点,在低质量屏幕上几乎看不出。也不要只靠颜色变化,加粗轮廓、改变背景、加一个偏移,都能让位置更明确。

语义与 ARIA:先靠原生,再谈补丁

ARIA 是一组给元素补充「角色、状态、名称」的属性,专门用来描述那些原生标签表达不了的自定义组件。它有一个很出名的原则:如果原生标签或属性已经能表达,就不要用 ARIA。比如 button 本身就是按钮,再写 role="button" 是多余的;input type="checkbox" 本身就是复选框,再包一层 role="checkbox" 只会添乱。

ARIA 只改「读屏软件怎么理解」,不改「元素实际怎么工作」。写了 role="button",它不会自动获得键盘响应;写了 aria-expanded="true",面板不会自动展开。行为和状态都得自己用脚本维护。这是很多人用错 ARIA 的根源:以为加了属性就万事大吉,实际只是给读屏软件报了一个不准确的状态。

属性作用典型场景
aria-label直接给元素一个名称只有图标的按钮,如「关闭」「上一页」
aria-labelledby用页面上某段文字当名称弹窗标题、分组标题
aria-describedby关联补充说明输入框的错误提示、格式要求
aria-hidden="true"让读屏软件忽略纯装饰图标、重复的文字
aria-expanded表示展开或收起折叠面板、下拉菜单
aria-live内容变化时主动播报表单提交结果、搜索无结果提示

用 aria-hidden="true" 要小心:它会把元素从读屏软件的视角里彻底移除,如果里面还有可聚焦的链接或按钮,键盘用户仍然能 Tab 进去,但读屏软件什么都不念,等于制造了一个「黑洞」。隐藏装饰元素时,确认里面没有交互控件。

还要注意,元素有了 role 不等于有了「可访问名称」。图标按钮只有图形,没有文字,必须用 aria-label 或隐藏文本补上名字,否则读屏软件只会念「按钮」。名称要写动作,比如「关闭对话框」,不要写「图标」。

对比度:不是审美问题,是可读性问题

浅灰字配白底,在设计师的显示器上很优雅,在户外阳光下、在廉价笔记本屏幕上、对视力下降的用户来说,基本看不清。可访问性规范给了一个可量化的门槛:正文文字和背景的对比度至少 4.5:1;大号文字(约 24 像素以上,或约 18.7 像素以上的粗体)可以放宽到 3:1。图标、边框这类界面元素至少 3:1。

这些数值来自 WCAG 的 AA 级要求,是可验证的,不是拍脑袋。计算对比度有现成工具,输入两个颜色就能得到比值。要注意的是渐变背景、图片上的文字,工具算的是纯色,实际效果可能更差,这类场景建议加一层半透明底色再放字。

还有一条同样重要:不要只靠颜色传递信息。表单错误只把边框变红,色觉障碍用户看不出来;图表只靠红绿区分数据系列,一部分人分不清。补一个图标、一段文字、一种线型,问题就解决了。这个成本很低,但经常被忽略。

读屏软件到底怎么读你的页面

读屏软件不是「看图说话」,它读的是结构:元素名称、角色、状态、文字内容,顺序基本跟随 DOM。所以有三件事直接影响体验:

  • 标题层级。用户可以按快捷键在 h2、h3 之间跳。层级乱了,大纲就断了,用户会以为自己跳过了某一块内容。
  • 可访问名称。输入框靠 label,图标按钮靠 aria-label,链接靠自身文字或图片 alt。没有名称的控件,读屏软件只能报「按钮」,用户不知道是哪个。
  • 地标区域。header、nav、main、aside、footer 会变成可跳转的地标。语义化那篇讲的收益,在这里体现得最直接。

页面语言也会影响朗读。根元素上的 lang="zh-CN" 告诉读屏软件用哪种发音规则,中文页面里夹着大段英文时,可以用带 lang 的内联元素切换。语言标错,读屏软件会用奇怪的腔调念中文,理解成本明显上升。

一个具体的例子:商品卡片如果整张都做成一个链接,读屏软件会把标题、价格、描述、按钮文字全部连起来念一遍,用户听完才知道这是一件商品。更好的做法是标题做链接,其他信息正常呈现,卡片整体的点击用脚本补,同时保证标题链接可聚焦。这里没有唯一答案,取舍取决于卡片的信息量和交互复杂度。

一次自定义下拉框的走查

设计稿要求下拉选择器带分组标题和图标,原生 select 的选项样式做不出来。第一版用 div 拼:点击展开面板,点选项就选中并收起。鼠标操作一切正常,代码也短,评审时没人觉得有问题。

键盘验收时问题一个接一个。Tab 直接跳过了它,因为 div 默认不可聚焦;加上 tabindex="0" 后能聚焦了,但按回车不展开,因为展开只绑定了 click;补了 keydown 后能展开,方向键却不会在选项间移动。更麻烦的是读屏软件:加了 role="combobox" 和 aria-expanded,但展开、收起时忘了同步属性,读屏软件报的状态和实际界面相反。

第二版决定按 ARIA 的完整模式补:listbox 和 option 角色、aria-activedescendant 跟踪当前项、上下键移动、回车选择、Esc 关闭、点击外部关闭、打开时把焦点移进面板、关闭后把焦点还给触发按钮。写到一半发现,另一个「多选下拉」也要同样的逻辑,而且行为和单选还不一样。粗算下来两百多行键盘代码,每个变体都要重新测一遍。

最后的决定是退回原生 select,接受视觉上的妥协:去掉分组图标,用 CSS 调整字体、边框和尺寸,让它在设计稿里「不那么突兀」。产品最初不接受,看到键盘验收的结果后同意了。这个选择的代价是外观不够精致,收益是键盘、读屏、移动端选择器全都不用自己维护。

复盘时我意识到,这不是「技术做不到」,而是维护成本的问题。自研一个下拉不难,难的是之后每加一个变体、每改一次交互,都要把整套键盘和播报逻辑重新验证一遍。原生控件无趣,但它把这些工作都做完了。如果团队里没有专人长期维护,下一任接手的人大概率会把这些坑再踩一遍。

错误现象对照

可访问性的症状往往很隐蔽:鼠标用户一切正常,只有换一种操作方式才会暴露。下面这些现象可以当作排查入口。

现象真实原因第一步查什么
Tab 按过去,页面没有任何可见变化全局重置了 outline,或焦点样式被覆盖看 :focus 和 :focus-visible 的样式是否还在
自定义按钮用键盘按不动用 div 或 span 拼的,没有焦点和键盘事件看标签是不是 button,或有没有 tabindex 与键盘监听
读屏只念「按钮」,不念名字图标按钮没有 aria-label,图片缺 alt检查元素的可访问名称来源
点复选框文字不切换选中label 没有绑定,或 for 与 id 不匹配看 label 的 for 是否指向存在的唯一 id
Tab 顺序乱跳,不按视觉位置走用了正整数的 tabindex,或 CSS 改变了视觉顺序全局搜 tabindex,对比 DOM 顺序和视觉顺序
弹窗打开后,焦点还在背后的页面没有做焦点管理,也没让背景不可交互打开后看当前焦点在哪,背景是否还能 Tab 进去
提交失败,读屏软件毫无反应错误提示没有关联,也没有实时播报区域看 aria-describedby 和 aria-live 是否生效
浅灰说明文字看不清文字与背景对比度低于 4.5:1用取色工具算对比度,重点看次要文字

边界与代价:做到哪一步为止

先分清两个层次。「基本可用」包括:所有交互都能用键盘完成、焦点可见、原生标签优先、文字对比度达标、信息不只靠颜色。这些大多是顺手的事,成本低,收益覆盖了大部分阻断性问题。「完整无障碍」则要给每个自研组件补键盘映射、焦点管理、状态播报,还要在不同读屏软件上逐一验证,成本会明显上升。

项目初期至少守住基本可用,别在还没有用户时就追求满分;但也不能因为「用户里没有盲人」就完全不做。键盘用户、临时受伤的人、在强光下看屏幕的人,数量比想象中多。真正该算的账是:一个自定义组件省下的设计时间,是否值得用后续持续的键盘和播报维护来换。

规模上去后,问题会从「单个页面」变成「组件库」。同一个下拉、弹窗、标签页在多个项目里各写一遍,无障碍补丁也会各写一遍,而且质量参差。比较稳的做法是把这些交互收进统一的组件库,键盘行为、焦点规则、ARIA 状态在一处维护,业务侧只负责组合。代价是前期投入和约束,收益是新增页面不用重新踩一遍坑。

几个常见副作用也要说清:

  • aria-hidden="true" 盖住可聚焦元素,会制造读屏「黑洞」,键盘能进去但没有任何朗读。
  • 把 legend、label 用 display: none 隐藏,视觉干净了,语义也没了。要藏用裁剪样式。
  • 过度使用 ARIA 比不用更糟。角色和状态报错,比「没有额外信息」更容易误导用户。
  • 自动化工具只能扫出缺 alt、对比度不足、标签嵌套错误这类问题,扫不出焦点顺序是否合理、提示语是否说得清。它适合当第一道筛子,不适合当验收标准。
  • 读屏软件之间的行为存在差异,NVDA、JAWS、VoiceOver 对同一个自定义组件的播报不一定一致,具体表现随版本变化,这里标为待确认,必须以真实测试为准。

还有一个现实约束:无障碍问题很难靠「看代码」发现。必须真的拔掉鼠标、真的打开读屏软件、真的把页面放大到 200%。自动化报告全绿,不代表键盘用户能走完流程。

小结与下一步

记住四条底线:所有交互都能用键盘完成;焦点始终看得见;原生标签优先,ARIA 只做补充;文字对比度达标、信息不只靠颜色。这四条覆盖了入门阶段八成的问题,剩下的可以等具体组件遇到时再查规范。

下面几件事当天就能自己验证:

  1. 拔掉鼠标,用 Tab、Shift+Tab、回车和空格走完登录和搜索流程,记录第一个卡住的位置。
  2. 全局搜索 tabindex,把正整数改掉,确认 Tab 顺序跟 DOM 一致。
  3. 打开系统朗读或 NVDA,听一遍首页和一篇文章,重点听图标按钮有没有名字。
  4. 把页面放大到 200%,检查文字是否被截断、内容是否重叠、横向是否要来回滚动。
  5. 用取色工具算一下正文和次要说明文字的对比度,低于 4.5:1 的记下来。

HTML 这一组到这里结束。接下来进入 CSS,先讲选择器,因为「样式为什么不生效」大多从这儿开始;再讲层叠与优先级,解释为什么你写的规则被别的规则压住了。下一篇 选择器 会从最常见的失效场景切入,把选择器的匹配规则和优先级一次说清。