# 无障碍说明

本页说明 Raise 网页端（工作台、一方应用、登录页、控制台）的无障碍目标、已经做到的，以及已知的缺口。手机应用不在本页范围内。

## 目标

所有网页前端达到 **WCAG 2.1 AA**，键盘和读屏软件都能用。

> **注意**
>
> 这是目标，不是认证结论。Raise 没有第三方的无障碍认证。下文「已知缺口」列出了还没有覆盖的部分。

## 怎么检查

| 检查 | 看什么 | 什么时候跑 |
|---|---|---|
| 静态检查 | 只有图标的按钮没有名字、图片没有替代文字、可点击的非交互元素没有角色和键盘处理、去掉焦点轮廓却没有替代样式等 | 每次提交，在持续集成里 |
| 组件测试 | 用 axe 检查每个新部件，中英文、展开和收起状态都不能有严重或关键级问题 | 随组件库的测试一起跑 |
| 真实环境审计 | 用 axe-core 按 WCAG 2.0 / 2.1 A 与 AA 检查登录页、工作台和每个一方应用，浅色和深色各一遍 | 改了共享组件、主题，或新应用上线时 |

### 2026-10-06 第一轮审计

- 修复后检查了 210 个页面状态（浅色和深色）：严重和关键级问题为 0。
- 剩 1 条中等级问题：在文档或知识库里打开一个标题为空的新页面时，页面没有带文字的一级标题。
- 键盘实测（工作台和人力资源，连按 Tab 70 次）：应用内每个停靠点都有可见的焦点环。

## 已经做到的

| 方面 | 做法 |
|---|---|
| 对比度 | 正文对比度不低于 4.5:1，大字不低于 3:1。次要文字和状态色会向正文色拉近一些，组织自定义的品牌色也照此处理；深色模式下对比度只升不降 |
| 页面结构 | 每页有主内容、页头和带名字的导航区域，每页一个一级标题 |
| 名字 | 只有图标的按钮都有名字，由检查强制 |
| 键盘 | 工作台按 Tab 的第一站是「跳到对话」，只在获得焦点时出现 |
| 减少动态效果 | 系统设置里的「减少动态效果」生效：不再位移、缩放、旋转，装饰性的循环动画停下；表示「正在处理」的转圈和脉冲保留 |
| 高对比度主题 | Windows 的对比度主题下，输入框、复选框、卡片、浮层的边框用系统颜色画回来 |
| 图表 | 组件库里的图表都有名字；有悬停读数的图表可以用方向键逐个读；每个图表附一张读屏软件可读的数据表 |
| 语言与外观 | 界面有简体中文和 English，在账号菜单里切换；外观可选浅色、深色、跟随系统。每一句界面文字都有英文，由自动检查保证 |

## 已知缺口

- 运营台、开放平台、「我的组织」、消息中心、草稿、账号、公开付款页、站点公开页还没有跑 axe 审计。它们用同一套页面框架和颜色，但没有逐页验证。
- 只审计了没有数据的页面和第一个「新建」对话框。有数据时的表格、详情页、展开的下拉菜单、提示消息、助手对话里的卡片，还没有逐一审计。
- 还没有用真实的读屏软件（VoiceOver、NVDA）走完整流程。
- 分析、触达应用里的图表用的是另一套图表库，数据没有文字替代。
- 会员课表和资源时间条上「点空白处选时间」只能用指针操作；用键盘时，改用页面上的「排课」和起止时间字段。