accessibility-rules
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDocument Accessibility Rules Reference
文档无障碍规则参考
Rule ID Prefixes
规则ID前缀
| Prefix | Format | Sub-Agent | Count |
|---|---|---|---|
| DOCX-E* | Word errors | word-accessibility | 9 rules |
| DOCX-W* | Word warnings | word-accessibility | 6 rules |
| DOCX-T* | Word tips | word-accessibility | 3 rules |
| XLSX-E* | Excel errors | excel-accessibility | 8 rules |
| XLSX-W* | Excel warnings | excel-accessibility | 5 rules |
| XLSX-T* | Excel tips | excel-accessibility | 3 rules |
| PPTX-E* | PowerPoint errors | powerpoint-accessibility | 7 rules |
| PPTX-W* | PowerPoint warnings | powerpoint-accessibility | 6 rules |
| PPTX-T* | PowerPoint tips | powerpoint-accessibility | 4 rules |
| PDFUA.* | PDF/UA conformance | pdf-accessibility | 30 rules |
| PDFBP.* | PDF best practices | pdf-accessibility | 22 rules |
| PDFQ.* | PDF quality/pipeline | pdf-accessibility | 4 rules |
| EPUB-E* | ePub errors | epub-accessibility | 7 rules |
| EPUB-W* | ePub warnings | epub-accessibility | 6 rules |
| EPUB-T* | ePub tips | epub-accessibility | 3 rules |
| 前缀 | 格式 | 子Agent | 数量 |
|---|---|---|---|
| DOCX-E* | Word错误 | word-accessibility | 9条规则 |
| DOCX-W* | Word警告 | word-accessibility | 6条规则 |
| DOCX-T* | Word优化建议 | word-accessibility | 3条规则 |
| XLSX-E* | Excel错误 | excel-accessibility | 8条规则 |
| XLSX-W* | Excel警告 | excel-accessibility | 5条规则 |
| XLSX-T* | Excel优化建议 | excel-accessibility | 3条规则 |
| PPTX-E* | PowerPoint错误 | powerpoint-accessibility | 7条规则 |
| PPTX-W* | PowerPoint警告 | powerpoint-accessibility | 6条规则 |
| PPTX-T* | PowerPoint优化建议 | powerpoint-accessibility | 4条规则 |
| PDFUA.* | PDF/UA合规 | pdf-accessibility | 30条规则 |
| PDFBP.* | PDF最佳实践 | pdf-accessibility | 22条规则 |
| PDFQ.* | PDF质量/流水线 | pdf-accessibility | 4条规则 |
| EPUB-E* | ePub错误 | epub-accessibility | 7条规则 |
| EPUB-W* | ePub警告 | epub-accessibility | 6条规则 |
| EPUB-T* | ePub优化建议 | epub-accessibility | 3条规则 |
WCAG 2.2 Criterion Mapping
WCAG 2.2 标准映射
Complete tracking of all WCAG 2.2 Level A and AA success criteria. Criteria with document-specific rules list the rule IDs. Criteria requiring human judgment show "Manual review". Criteria that apply only to web/app contexts show a dash. See the wcag-guide agent for full explanations of each criterion.
Note: WCAG 2.2 removed 4.1.1 Parsing (it is "always satisfied" in modern user agents and no longer tested).
完整覆盖所有WCAG 2.2 A级和AA级成功标准。有对应文档专属规则的标准会列出规则ID,需要人工判断的标准标注为「人工审核」,仅适用于网页/应用场景的标准标注为短横线。如需了解每个标准的完整说明,请查看wcag-guide Agent。
注意: WCAG 2.2 已移除4.1.1 解析标准(现代用户代理已默认满足该要求,不再进行检测)。
Level A (Must Fix)
A级(必须修复)
| WCAG | Criterion | Related Rules |
|---|---|---|
| 1.1.1 | Non-text Content | DOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005 |
| 1.2.1 | Audio-only and Video-only (Prerecorded) | Manual review (embedded media) |
| 1.2.2 | Captions (Prerecorded) | Manual review (embedded video) |
| 1.2.3 | Audio Description or Media Alternative (Prerecorded) | Manual review (embedded video) |
| 1.3.1 | Info and Relationships | DOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS |
| 1.3.2 | Meaningful Sequence | PPTX-E006, PDFUA.READING_ORDER, EPUB-E006 |
| 1.3.3 | Sensory Characteristics | Manual review (all formats) |
| 1.4.1 | Use of Color | XLSX-E007, Manual review (other formats) |
| 1.4.2 | Audio Control | Manual review (embedded audio) |
| 2.1.1 | Keyboard | PDFUA.FORMS (interactive PDFs) |
| 2.1.2 | No Keyboard Trap | PDFUA.FORMS (interactive PDFs) |
| 2.1.4 | Character Key Shortcuts | --- (web/app-specific) |
| 2.2.1 | Timing Adjustable | --- (web/app-specific) |
| 2.2.2 | Pause, Stop, Hide | Manual review (animated content in documents) |
| 2.3.1 | Three Flashes or Below Threshold | Manual review (animated content) |
| 2.4.1 | Bypass Blocks | PDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004 |
| 2.4.2 | Page Titled | DOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001 |
| 2.4.3 | Focus Order | PDFUA.FORMS (interactive PDFs) |
| 2.4.4 | Link Purpose (In Context) | DOCX-E006, XLSX-E005, PPTX-E005 |
| 2.5.1 | Pointer Gestures | --- (web/app-specific) |
| 2.5.2 | Pointer Cancellation | --- (web/app-specific) |
| 2.5.3 | Label in Name | PDFUA.FORMS (interactive PDFs) |
| 2.5.4 | Motion Actuation | --- (web/app-specific) |
| 3.1.1 | Language of Page | DOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003 |
| 3.2.1 | On Focus | --- (web/app-specific) |
| 3.2.2 | On Input | --- (web/app-specific) |
| 3.2.6 | Consistent Help | --- (web/app-specific) |
| 3.3.1 | Error Identification | PDFUA.FORMS (interactive PDFs) |
| 3.3.2 | Labels or Instructions | PDFUA.FORMS (interactive PDFs) |
| 3.3.7 | Redundant Entry | --- (web/app-specific) |
| 4.1.2 | Name, Role, Value | DOCX-E009, PDFUA.FORMS, PDFUA.TAGS |
| WCAG | 标准项 | 相关规则 |
|---|---|---|
| 1.1.1 | 非文本内容 | DOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005 |
| 1.2.1 | 纯音频和纯视频(预录制) | 人工审核(嵌入式媒体) |
| 1.2.2 | 字幕(预录制) | 人工审核(嵌入式视频) |
| 1.2.3 | 音频描述或媒体替代方案(预录制) | 人工审核(嵌入式视频) |
| 1.3.1 | 信息与关系 | DOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS |
| 1.3.2 | 有意义的顺序 | PPTX-E006, PDFUA.READING_ORDER, EPUB-E006 |
| 1.3.3 | 感官特性 | 人工审核(所有格式) |
| 1.4.1 | 颜色使用 | XLSX-E007, 人工审核(其他格式) |
| 1.4.2 | 音频控制 | 人工审核(嵌入式音频) |
| 2.1.1 | 键盘操作 | PDFUA.FORMS(交互式PDF) |
| 2.1.2 | 无键盘陷阱 | PDFUA.FORMS(交互式PDF) |
| 2.1.4 | 字符快捷键 | ---(网页/应用专属) |
| 2.2.1 | 可调整计时 | ---(网页/应用专属) |
| 2.2.2 | 暂停、停止、隐藏 | 人工审核(文档内动画内容) |
| 2.3.1 | 三次闪烁或低于阈值 | 人工审核(动画内容) |
| 2.4.1 | 绕过模块 | PDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004 |
| 2.4.2 | 页面标题 | DOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001 |
| 2.4.3 | 焦点顺序 | PDFUA.FORMS(交互式PDF) |
| 2.4.4 | 链接目的(上下文内) | DOCX-E006, XLSX-E005, PPTX-E005 |
| 2.5.1 | 指针手势 | ---(网页/应用专属) |
| 2.5.2 | 指针取消 | ---(网页/应用专属) |
| 2.5.3 | 名称匹配 | PDFUA.FORMS(交互式PDF) |
| 2.5.4 | 动作触发 | ---(网页/应用专属) |
| 3.1.1 | 页面语言 | DOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003 |
| 3.2.1 | 获得焦点时 | ---(网页/应用专属) |
| 3.2.2 | 输入时 | ---(网页/应用专属) |
| 3.2.6 | 一致的帮助信息 | ---(网页/应用专属) |
| 3.3.1 | 错误识别 | PDFUA.FORMS(交互式PDF) |
| 3.3.2 | 标签或说明 | PDFUA.FORMS(交互式PDF) |
| 3.3.7 | 冗余输入 | ---(网页/应用专属) |
| 4.1.2 | 名称、角色、值 | DOCX-E009, PDFUA.FORMS, PDFUA.TAGS |
Level AA (Should Fix)
AA级(建议修复)
| WCAG | Criterion | Related Rules |
|---|---|---|
| 1.2.4 | Captions (Live) | --- (web/app-specific) |
| 1.2.5 | Audio Description (Prerecorded) | Manual review (embedded video) |
| 1.3.4 | Orientation | --- (web/mobile-specific) |
| 1.3.5 | Identify Input Purpose | PDFUA.FORMS (interactive PDFs) |
| 1.4.3 | Contrast (Minimum) | Manual review (Office formats), PDFBP.Contrast |
| 1.4.4 | Resize Text | Manual review (PDF reflow) |
| 1.4.5 | Images of Text | PDFBP.IMG_TEXT |
| 1.4.10 | Reflow | Manual review (PDF reflow) |
| 1.4.11 | Non-text Contrast | Manual review (all formats) |
| 1.4.12 | Text Spacing | Manual review (PDF text spacing) |
| 1.4.13 | Content on Hover or Focus | --- (web/app-specific) |
| 2.4.5 | Multiple Ways | Manual review (multi-page documents) |
| 2.4.6 | Headings and Labels | DOCX-E003, DOCX-E007, PDFUA.HEADINGS |
| 2.4.7 | Focus Visible | PDFUA.FORMS (interactive PDFs) |
| 2.4.11 | Focus Not Obscured (Minimum) | --- (web/app-specific) |
| 2.5.7 | Dragging Movements | --- (web/app-specific) |
| 2.5.8 | Target Size (Minimum) | Manual review (interactive PDFs) |
| 3.1.2 | Language of Parts | Manual review (Office formats), PDFUA.LANG_PARTS |
| 3.2.3 | Consistent Navigation | --- (web/app-specific) |
| 3.2.4 | Consistent Identification | --- (web/app-specific) |
| 3.3.3 | Error Suggestion | PDFUA.FORMS (interactive PDFs) |
| 3.3.4 | Error Prevention (Legal, Financial, Data) | PDFUA.FORMS (interactive PDFs) |
| 3.3.8 | Accessible Authentication (Minimum) | --- (web/app-specific) |
| 4.1.3 | Status Messages | --- (web/app-specific) |
| WCAG | 标准项 | 相关规则 |
|---|---|---|
| 1.2.4 | 字幕(实时) | ---(网页/应用专属) |
| 1.2.5 | 音频描述(预录制) | 人工审核(嵌入式视频) |
| 1.3.4 | 方向 | ---(网页/移动端专属) |
| 1.3.5 | 识别输入目的 | PDFUA.FORMS(交互式PDF) |
| 1.4.3 | 对比度(最低要求) | 人工审核(Office格式), PDFBP.Contrast |
| 1.4.4 | 文本缩放 | 人工审核(PDF重排) |
| 1.4.5 | 文本图像 | PDFBP.IMG_TEXT |
| 1.4.10 | 重排 | 人工审核(PDF重排) |
| 1.4.11 | 非文本对比度 | 人工审核(所有格式) |
| 1.4.12 | 文本间距 | 人工审核(PDF文本间距) |
| 1.4.13 | 悬停或聚焦时的内容 | ---(网页/应用专属) |
| 2.4.5 | 多种导航方式 | 人工审核(多页文档) |
| 2.4.6 | 标题与标签 | DOCX-E003, DOCX-E007, PDFUA.HEADINGS |
| 2.4.7 | 焦点可见 | PDFUA.FORMS(交互式PDF) |
| 2.4.11 | 焦点不被遮挡(最低要求) | ---(网页/应用专属) |
| 2.5.7 | 拖拽操作 | ---(网页/应用专属) |
| 2.5.8 | 目标大小(最低要求) | 人工审核(交互式PDF) |
| 3.1.2 | 部分内容语言 | 人工审核(Office格式), PDFUA.LANG_PARTS |
| 3.2.3 | 一致的导航 | ---(网页/应用专属) |
| 3.2.4 | 一致的标识 | ---(网页/应用专属) |
| 3.3.3 | 错误建议 | PDFUA.FORMS(交互式PDF) |
| 3.3.4 | 错误预防(法律、金融、数据) | PDFUA.FORMS(交互式PDF) |
| 3.3.8 | 无障碍身份验证(最低要求) | ---(网页/应用专属) |
| 4.1.3 | 状态消息 | ---(网页/应用专属) |
Severity Definitions
严重程度定义
| Severity | Meaning | Impact on AT Users |
|---|---|---|
| Error | Blocks access | Content is inaccessible or unusable with assistive technology |
| Warning | Degrades experience | Content is accessible but the experience is poor or confusing |
| Tip | Best practice | Content works but could be improved for better AT experience |
| 严重等级 | 含义 | 对辅助技术用户的影响 |
|---|---|---|
| 错误 | 阻断访问 | 内容无法通过辅助技术访问或使用 |
| 警告 | 体验降级 | 内容可访问,但体验较差或容易造成混淆 |
| 优化建议 | 最佳实践 | 内容可正常使用,但可进一步优化提升辅助技术使用体验 |
Confidence Levels
置信度等级
| Level | Weight | Meaning |
|---|---|---|
| High | 1.0 | Sub-agent is certain this is a real issue |
| Medium | 0.7 | Likely an issue but requires human judgment |
| Low | 0.3 | Possible issue - flagged for review |
| 等级 | 权重 | 含义 |
|---|---|---|
| 高 | 1.0 | 子Agent确认这是真实存在的问题 |
| 中 | 0.7 | 大概率是问题,但需要人工判断确认 |
| 低 | 0.3 | 可能存在问题,标记供人工审核 |
Compliance Standards
合规标准
| Standard | Scope | Key Rules |
|---|---|---|
| WCAG 2.2 Level A | International | All error-level rules |
| WCAG 2.2 Level AA | International | All error + warning rules |
| Section 508 | US Federal | Mapped to WCAG 2.0 Level AA |
| EN 301 549 | European Union | Mapped to WCAG 2.1 Level AA |
| PDF/UA (ISO 14289) | PDF-specific | All PDFUA.* rules |
| 标准 | 适用范围 | 核心规则 |
|---|---|---|
| WCAG 2.2 A级 | 国际 | 所有错误级规则 |
| WCAG 2.2 AA级 | 国际 | 所有错误+警告级规则 |
| Section 508 | 美国联邦 | 映射到WCAG 2.0 AA级 |
| EN 301 549 | 欧盟 | 映射到WCAG 2.1 AA级 |
| PDF/UA (ISO 14289) | PDF专属 | 所有PDFUA.*规则 |