必须每轮发布前人工核对alt、aria-label/aria-labelledby、lang三项属性,因内容更新、多语言切换或CMS复用易致其失效:alt须有意义或为空字符串,图标按钮必设aria-label,lang须同步更新为合法BCP 47标签。

哪些HTML属性必须每轮发布前人工核对
alt、aria-label/aria-labelledby、lang 这三项不是“写一次就完事”的属性,内容更新、多语言切换、CMS模板复用时极易失效。运营扔来一张新图,alt可能还是上季度的促销文案;中英文切换后,没跟着变,屏幕阅读器就按英语规则读中文词;图标按钮加了新功能,但aria-label还写着“搜索”,用户听到的就是错信息。
必须做到:
-
alt值不能是空格、"图片"、"logo",装饰图必须写alt=""(空字符串),不是省略 - 所有带交互的图标(如
)必须显式加aria-label,不能依赖视觉样式 - 多语言切换动作触发后,
lang属性要同步更新,且必须是合法BCP 47标签(如en-US、ja-JP,不能写english)
表单标签关联失效的典型表现与修复方式
CMS拖拽生成的表单、React/Vue动态渲染的input,常出现label和input无绑定——placeholder当提示、for指向不存在的id、或者input被包在div里却没包进label。结果就是:键盘用户Tab到输入框,听不到任何说明;屏幕阅读器只报“编辑文本”,不报“邮箱地址”。
修复不靠猜测,靠检查:
- 打开开发者工具,选中
input,看label是否出现在accessibility面板的“Related nodes”里 - 确保
label[for]和input[id]严格匹配(大小写、连字符、空格全算) - required字段除了原生
required,建议补aria-required="true"(部分旧版NVDA不识别原生属性) - 错误提示容器加
aria-live="polite",否则错误消息弹出来,屏幕阅读器根本不会读
动态插入内容后焦点和语义丢失怎么补
AJAX加载列表、点击展开FAQ、表单提交成功弹Toast——这些操作一执行,新DOM节点就插进来了,但焦点没动、语义没声明、屏幕阅读器还在读上一段。用户卡在空白处,或反复读“按钮”却不告诉它是干啥的。
关键不是“等它自动好”,而是手动干预:
- 新内容含可聚焦元素(如第一个
button或a),插入后立刻element.focus() - 模态框用
aria-modal="true",同时给背景加inert或aria-hidden="true"(注意:IE不支持inert,得降级处理) - 加载中状态标记父容器
aria-busy="true",完成后再设为false,避免读屏器抢读未渲染完的内容 - 绝对不用
display: none隐藏导航菜单——改用visibility: hidden+position: absolute+clip: rect(0 0 0 0)组合,确保仍被读屏器感知
键盘导航验证为什么不能被自动化工具替代
自动化扫描工具(如axe、WAVE)能抓出90%的静态属性缺失,但抓不出“Tab键卡死在某个轮播图”“Enter按了没反应”“焦点跳过整个侧边栏”。因为这些是行为问题,不是语法问题。
每月至少做一次纯键盘走查:
- 只用
Tab/Shift+Tab/Enter/Space,不碰鼠标 - 重点测:导航栏是否可进可出、表单是否顺序合理、模态框关闭后焦点是否回到触发按钮、滚动锚点是否可聚焦
- 卡住的位置,十有八九是
tabindex="-1"误加、focus()没调、或aria-hidden="true"锁死了不该锁的区域
这事没法外包,也没法靠CI跑完就放心——人手一遍,比扫一百次代码更管用。最常被跳过的,就是这一步。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











