交互与用户体验 / 知识点
无障碍设计术语速查手册
标准与规范
Accessible Rich Internet Applications 标准族,用 Role、State、Property 等补充动态 Web 控件的可访问语义;不是替代原生 HTML 的万能层。
定义
**WAI-ARIA(常简称 ARIA)**用于补充 Web UI 缺失的可访问语义。
核心组成
Role
State
Property
Relationships原则
优先使用原生 HTML 语义;只有 Host Language 无法表达时再使用 ARIA 补充。
最小例子
自定义 Tab 组件需要正确 Role、Selected State、关系和键盘行为。
常见误区
“加了 role 就可访问”是错误的。ARIA 不会自动补齐键盘、Focus 和交互行为。
WAI-ARIA 当前稳定 Recommendation 版本,定义 Web UI 的 Role、State 和 Property 语义及其辅助技术映射基础。
定义
WAI-ARIA 1.2 是当前稳定的 W3C Recommendation。
用途
用于描述:
- Widgets
- Structures
- States
- Properties
- Relationships
边界
ARIA 1.3 仍在开发,因此产品稳定实现应以已发布规范和成熟浏览器/AT 支持为基础。
常见误区
不要为了使用“最新 ARIA 属性”而忽略真实 Browser + AT Support。
描述可访问对象是什么类型的语义,如 button、dialog、tab、navigation;Role 会影响辅助技术如何理解和操作元素。
定义
ARIA Role 回答:
这个对象是什么?
例如:
button
dialog
tab
navigation
status边界
Role 只定义语义身份,不自动实现外观或行为。
最小例子
role="button" 不会自动让 div 支持 Enter / Space。
常见误区
如果原生 HTML 已经有合适元素,通常不需要重复声明 Role。
描述可访问对象当前会变化的状态,如 expanded、selected、checked、disabled;状态必须随真实 UI 变化同步更新。
定义
ARIA State 描述控件当前处于什么状态。
常见:
aria-expandedaria-selectedaria-checkedaria-disabled
最小例子
Accordion 展开后:
aria-expanded = true关闭后应同步变为 false。
常见误区
ARIA State 与视觉状态不同步,会让屏幕阅读器获得错误信息。
描述控件相对稳定的可访问属性和关系,如 label、description、controls、required;用于向辅助技术补充语义。
定义
ARIA Property 向 Accessibility Tree 提供额外信息。
常见:
aria-labelaria-labelledbyaria-describedbyaria-controlsaria-required
边界
不同属性有严格适用 Role 和语义规则。
常见误区
不要把 ARIA 当作“随便给元素加备注”的系统;错误属性同样会损害可访问性。
能使用 HTML 原生控件和语义时优先使用原生元素,因为浏览器已提供键盘、状态和 Accessibility API 映射。
定义
**Native Semantics First(原生语义优先)**是 Web A11y 的核心实践原则。
示例
优先:
<button>
<input>
<nav>
<h1>而不是:
<div role="button">优势
原生元素通常已提供:
- Keyboard behavior
- Focus
- Name calculation
- Platform semantics
常见误区
ARIA 不会让自定义元素“自动等同原生控件”。
W3C 提供的 ARIA 组件模式和键盘交互实践指南,常简称 APG;适合参考复杂 Widget 的语义和交互模型。
定义
**APG(ARIA Authoring Practices Guide)**提供常见 Web Widget 的可访问设计模式。
覆盖例如:
- Tabs
- Dialog
- Menu
- Combobox
- Grid
- Tree
用途
帮助团队理解一个复杂组件需要哪些:
- Roles
- States
- Keyboard interactions
- Focus behavior
常见误区
APG 示例是学习和参考资源,不代表可以不理解上下文直接复制到任何产品。
语义与名称
使用与内容和交互意义匹配的原生 HTML 元素表达结构,例如 heading、button、nav、main;是 Web 无障碍的基础。
定义
**Semantic HTML(语义 HTML)**是选择最能表达内容真实意义的 HTML 元素。
示例
<h1> → heading
<button>→ action
<nav> → navigation
<main> → main content价值
语义会被 Browser 和 AT 直接理解。
常见误区
只用 div + class 还原视觉,并不会自动产生正确的 Accessibility Tree。
辅助技术识别一个控件时使用的主要名称,例如按钮“保存”、输入框“邮箱”;是 Name / Role / Value 模型的核心之一。
定义
**Accessible Name(可访问名称)**回答:
这个控件叫什么?
示例
Role: button
Name: 保存Name 可能来自:
- Visible text
<label>aria-labelledbyaria-label
边界
Name 应简洁描述对象身份,而不是塞入整段帮助说明。
常见误区
只有图标、没有 Accessible Name 的按钮,对屏幕阅读器用户可能只会被读成“按钮”。
在 Accessible Name 之外提供补充说明的信息,如格式要求、风险或辅助提示;不应重复 Name。
定义
**Accessible Description(可访问描述)**用于在对象名称之外提供额外上下文。
示例
Name: 密码
Description: 至少 8 位,包含数字常见来源
aria-describedby- Platform description mapping
边界
Description 是补充信息,不应替代清晰 Label。
常见误区
Name 和 Description 完全重复,会让屏幕阅读器产生冗余播报。
可访问控件最核心的语义信息:它叫什么、是什么、当前值或状态是什么;辅助技术依赖这些信息理解自定义控件。
定义
Name, Role, Value 是无障碍控件语义的核心模型。
Name → 音量
Role → slider
Value → 60%价值
用户需要知道:
- 这是什么?
- 它叫什么?
- 当前状态/值是什么?
常见误区
视觉完全一致的自定义控件,如果 NRV 不完整,对 AT 用户仍可能不可用。
为输入控件或界面对象提供明确名称的可见或程序化关联文本;表单 Label 应与对应控件建立真实语义关系。
定义
**Label(标签)**说明一个输入或控件是什么。
最佳情况
邮箱
[____________]并且“邮箱”通过程序化方式与 Input 关联。
边界
Placeholder 不是 Label 的等价替代。
常见误区
只在视觉上把文字放在 Input 旁边,不代表辅助技术知道它们有关联。
页面中可被辅助技术快速导航的重要区域语义,如 main、navigation、banner、contentinfo;适合大型页面结构定位。
定义
**Landmark(地标)**把页面拆分成重要功能区域。
常见:
- Main
- Navigation
- Banner
- Complementary
- Contentinfo
- Search
价值
Screen Reader 用户可以快速在 Landmark 之间跳转。
常见误区
每个小 Section 都设置 Landmark,会造成导航噪音;只标记真正重要的页面区域。
使用 H1–H6 或等价语义建立内容结构,使用户和辅助技术能够快速理解页面层级与跳转。
定义
**Heading Hierarchy(标题层级)**用层级化 Heading 表达页面内容结构。
示例
H1 页面标题
├─ H2 账户信息
│ └─ H3 安全设置
└─ H2 通知设置价值
屏幕阅读器用户常通过 Heading 快速扫描页面。
常见误区
不要为了字体大小选 Heading Level;视觉样式和语义层级应分开处理。
把一组相关项目标记为有序或无序列表,使辅助技术能够播报项目数量和结构;视觉上的一排项目不一定具有列表语义。
定义
**List Semantics(列表语义)**告诉辅助技术“一组项目属于同一列表”。
常见结构
- Ordered list
- Unordered list
- Description list
最小例子
导航菜单的若干同级链接可根据结构使用真实 List 语义。
常见误区
用大量换行和 div 模拟列表,会丢失项目数量和结构信息。
为真正二维数据提供行、列、表头和单元格关系,使辅助技术能知道某个数据属于哪个 Header;不应只靠视觉对齐。
定义
**Table Semantics(表格语义)**表达二维数据中的 Row / Column / Header 关系。
最小例子
读到“¥128”时,Screen Reader 应能关联到:
- Column: 价格
- Row: 商品 A
边界
布局用表格与数据表格不是同一概念。
常见误区
为了页面对齐使用 Table Markup,会给辅助技术制造错误数据语义。
程序化声明页面或局部文本所使用的自然语言,帮助屏幕阅读器选择正确发音规则和语音。
定义
**Language Declaration(语言声明)**告诉 User Agent 一段内容使用什么自然语言。
示例
页面:中文
局部:English价值
Screen Reader 可以切换正确的:
- Pronunciation
- Voice
- Speech rules
常见误区
页面是中文但 lang 仍标成英文,可能造成明显错误发音。
不承载信息、功能或必要语义的视觉内容,如纯装饰插图;应避免被辅助技术重复或无意义播报。
定义
**Decorative Content(装饰性内容)**是对理解页面和完成任务没有必要的信息。
典型处理
让其不进入或不干扰 Accessibility Tree。
最小例子
标题旁纯装饰的彩色波纹,无需被读作“蓝色波纹图”。
常见误区
不要把含有信息、状态或链接作用的图片误判成 Decorative。
视觉上不可见但仍保留给辅助技术读取的文本技术,常用于补充图标按钮名称;不能使用会同时从 Accessibility Tree 移除的隐藏方式。
定义
**Visually Hidden Text(视觉隐藏文本)**让文字不显示在视觉界面中,但仍可被 Assistive Technology 访问。
常见用途
- Icon button label
- Extra screen-reader context
边界
display: none 等方式通常会连同语义一起隐藏,不能达到相同目的。
常见误区
大量依赖视觉隐藏文本补救含糊 UI,可能说明可见文案本身也需要优化。
键盘与焦点
将纯装饰或重复元素从 Accessibility Tree 中排除的处理;必须确保被隐藏内容不是完成任务所需信息。
定义
Accessibility Hidden 表示某内容视觉上可能存在,但不应暴露给辅助技术。
适用
- Decorative duplicate
- Visual-only separator
- Repeated icon
风险
误隐藏:
- Button
- Error
- Label
- Important content
会让 AT 用户完全失去访问能力。
常见误区
不要把 aria-hidden 当作解决“屏幕阅读器读得太多”的快捷开关。