语义化最怕停在口号上。把抽象原则拆成可以逐条打勾的检查项,评审时不再争论「这样写算不算规范」,只需要看清单里哪几项没过。

01结构与层级

页面有且只有一个 h1,标题层级不跳级;存在 header、nav、main、footer 等 landmark,main 只有一个;列表用 ul / ol / dl 而不是用换行和符号拼;表格用 table 且配 caption 与 th 的 scope;段落用 p 而不是连续 br。这些项几乎都能用静态检查或 DOM 查询自动验证,是投入产出比最高的一组。

如果只能做一件事,就为「语义检查表」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。

02名称与状态

每个交互控件都有可访问名称:button 有文本或 aria-label,input 有关联的 label;链接文本能独立表意,避免整屏的「点击查看」;图片有 alt,纯装饰图用空 alt;图标按钮补名称;状态变化用 aria-expanded、aria-current、aria-invalid 等属性表达,而不是只靠颜色和类名。

如果只能做一件事,就为「语义检查表」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。

03机器可读性

表单控件有正确的 type 与 autocomplete 令牌;时间用 time 元素带 datetime;联系信息、地址、引用分别用对应元素;关键内容不依赖 CSS 生成文本;页面提供合理的 lang 与 title;结构化数据只在与可见内容一致时才添加。做完这十六项,绝大多数 WCAG 的失败点会在编码阶段就被拦住。

如果只能做一件事,就为「语义检查表」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。

要点速览

  • h1 唯一、标题不跳级、landmark 完整、main 唯一
  • 控件都有可访问名称,链接文本可独立理解
  • 状态用 ARIA 属性表达,不能只靠颜色或类名
  • 自动填充令牌、时间与引用元素补齐机器语义

清单的意义不在全,而在可复述、可自动化、可交接。