辅助技术验证系统规范¶
{
"scope": "global",
"triggers": {
"accessibility": [
"FR1",
"FR2",
"FR3",
"FR4",
"FR5",
"FR6",
"FR7",
"FR8",
"FR9",
"FR10",
"FR11",
"FR12",
"FR13",
"FR14",
"FR15",
"FR16",
"FR17",
"FR19"
]
}
}
意图¶
依赖辅助技术的人应当获得 Astryx 所宣称的焦点与播报结果,而不只是看似合理的测试 DOM 标记。Astryx 以它能产生的最强证据证明每一项宣称:单元(unit)、DOM、无障碍树(accessibility-tree)、axe 和真实浏览器(real-browser)检查。真实辅助技术(AT)观察为实际被读出或被导航的内容增添证明。当结果依赖于 AT 行为时,建议进行后续验证。
Astryx 中没有任何要求会将合并或发布关卡建立在无法产出的证据上。缺少真实 AT 观察永远不会阻止合并到 main 或稳定发布。
非目标¶
本规范不会:
- 要求每次无障碍变更都运行任何辅助技术或每一种浏览器;
- 以真实 AT 观察作为合并或发布的关卡;
- 将真实 AT 视为单元、DOM、无障碍树、axe 或浏览器测试的替代品,这些测试能更精确地证明不同的宣称;
- 定义消费者无障碍要求,或从单一工具或矩阵宣称符合整个无障碍标准;
- 在 AT 有意更改无害措辞但仍保留所需信息和顺序时,要求提供稳定的播报文本;
- 实现发布自动化、贡献表单、标签、机器人、测试夹具或测试基础设施;或
- 在这些独立维护的记录存在之前,将本政策复制到贡献者或发布指南中。
职权边界¶
AST-009 仅在真实 AT 后续分类、证据边界、合并与发布的证据门槛以及持久凭证方面取代公开的 Accessibility Checklist。该清单仍然是组件无障碍要求的消费者和贡献者门槛。
AST-009 不负责焦点环外观、交互模态行为、视觉或对比度方法、浏览器支持、组件主题或浮层行为。这些仍由交互模态、浏览器支持、组件主题表面、主题令牌、层运行时、浮层关闭以及所属组件记录负责。
要求¶
何时推荐真实 AT 后续验证¶
| ID | 规则 |
|---|---|
| FR1 | 该推荐遵循所宣称的用户结果。仅当预期结果依赖于 AT 特定行为时,才推荐真实 AT/浏览器后续验证:AT 如何暴露或播报焦点、AT 特定的焦点顺序、语音/盲文输出、浏览或虚拟光标行为、模式切换,或已知的 AT/浏览器差异。语义代码变更或仅涉及焦点的浏览器行为不是触发条件。该推荐绝不会使真实 AT 证据成为合并或发布要求(FR17)。 |
| FR2 | 焦点变更仅在涉及 AT 特定结果时才需要后续验证。当宣称依赖于 AT 如何暴露、播报或排序编程式、初始、恢复、复合或关闭后的焦点时,推荐进行真实 AT 后续验证。焦点目标、顺序、返回、键盘操作、焦点环样式、保持相同浏览器焦点目标的重构,或静态 tabIndex 修正本身并不构成推荐理由。所属组件和交互模态记录定义了这些浏览器和视觉行为。 |
| FR3 | 角色、名称和描述在无障碍树中证明。计算角色、无障碍名称或描述由无障碍树证据证明。当变更依赖该语义在进入或状态转换期间被播报、改变交互/浏览模式,或解决已知的 AT/浏览器差异时,还推荐进行真实 AT 后续验证。 |
| FR4 | 播报通过其路由方式来证明。实时区域、状态消息、警报、验证播报或加载/完成转换,由 DOM 和无障碍树证据证明其承载元素或通道、文本、紧急程度,以及每次发生会产生多少次更新。当成功取决于所读出的内容、其顺序、发生时机、是否重复或是否被跳过时,推荐进行真实 AT 后续验证。 |
| FR5 | 虚拟光标进入需要后续跟进。当成功取决于屏幕阅读器浏览或虚拟光标进入的位置、内容是否可从该进入点被发现,或用户能否在浏览与交互模式之间切换时,建议进行真实 AT 后续跟进。普通键盘 Tab 顺序且不涉及浏览模式主张的情况则不需要。 |
| FR6 | 已知差异会扩大后续跟进范围。当变更后的模式存在已记录的 AT/浏览器差异时,后续跟进须覆盖其每一已具名的侧,直至某负责人记录该差异不再适用。来自一侧的通过结果不能替代另一已知不同的侧。 |
| FR7 | 其他变更使用相称的证据。静态语义、键盘行为、颜色/对比度、目标尺寸、源代码顺序以及类似的无障碍变更,应使用能直接证明该主张的成本最低的证据层。它们不会仅仅因为是无障碍工作就获得真实 AT 后续跟进。 |
| FR8 | 依赖 AT 的主张会被明确命名。一项预期结果依赖 AT 行为的变更,应在记录中说明这一点,并指明用于证明可证明部分的更低层级证据。它无需矩阵、场景或发布记录即可合并。 |
各证据层证明的内容¶
此表界定了每一层可以主张的范围。它不取代当前组件、系列、浏览器支持、视觉、主题或审计记录所要求的证据。
每一层都是有边界的。通过某一层 MUST NOT 被描述为证明了分配给后续层的某项主张。
| 证据 | 它能证明 | 它不能证明 |
|---|---|---|
| 单元测试 | 状态推导、分支选择、回调效果、应用自有的排序,以及确定性回归。 | 浏览器焦点导航、无障碍 API 暴露,或 AT 输出。 |
| DOM | 被测状态中渲染的元素、属性、所有权标记、源代码顺序,以及作者提供的 ARIA 关系。 | 计算出的可访问名称/描述、平台无障碍映射、语音、浏览模式,或真实浏览器事件行为。 |
| 可访问性树 | 被测引擎中浏览器计算出的角色、名称、描述、状态、关系,以及聚焦的无障碍节点。 | AT 所播报的内容、播报时机/顺序、虚拟光标位置,或其他引擎/平台栈中的行为。 |
| axe | 所配置的 axe 版本在给定渲染状态下能以机械方式检测到的规则。 | 不存在所有无障碍缺陷、任务可用性、正确的焦点目标、完整的播报,或 AT 互操作性。 |
| 真实浏览器 | 实际的焦点目标/顺序/返回、键盘与指针行为、浏览器事件时机、原生语义,以及特定引擎的状态转换。 | 语音/盲文输出、浏览或虚拟光标进入,或特定 AT 的差异。 |
| 真实 AT/浏览器 | 观察到的语音/盲文内容与顺序、播报时机/重复、浏览或虚拟光标进入、模式转换,以及具名的 AT/浏览器互操作性。 | 未经测试的组合、未来版本,或超出所记录场景的主张。 |
| ID | 规则 |
|---|---|
| FR9 | 证据按声明组合。变更保留其底层证据。真实 AT 观察运行时,只会增加它能证明的声明,且 MUST NOT 替代对底层所拥有行为的确定性回归覆盖。 |
| FR10 | 被测状态即所声明的状态。证据演练承载用户结果的转换或状态,例如打开界面、移动焦点、产生状态更新、关闭并恢复焦点,或通过虚拟光标进入。仅包含组件的静态基线是不充分的。 |
| FR11 | “真实”指随产品发布的配对。真实 AT 检查在其受支持的操作系统上,对指名的随产品发布浏览器运行指名的辅助技术。虚拟机、远程机器或模拟器只有在运行该实际配对并保留被测输入/模式时才可接受。DOM 模拟器、无障碍快照、合成语音桩,或代替品牌浏览器的浏览器引擎,均不构成真实 AT 证据。 |
代表性矩阵¶
当真实 AT 后续验证运行时,其配对从结果和受支持平台中选取,而不是在每次变更时完整复制。
| 代表性配对 | 当结果包含以下情况时使用 |
|---|---|
| NVDA + Windows 版 Chrome | 在 Chromium/Windows 技术栈上,与浏览器无关的桌面 AT 专属焦点呈现/顺序或播报行为。 |
| VoiceOver + macOS 版 Safari | 在 Safari/macOS 平台技术栈上,与浏览器无关的桌面 AT 专属焦点呈现/顺序或播报行为。 |
| NVDA + Windows 版 Firefox | Gecko 专属行为,或指名的 NVDA Chrome/Firefox 差异。 |
| VoiceOver + iOS 版 Safari | 触控驱动的 iOS 行为、移动版 Safari、转子/浏览导航,或 iOS 专属差异。 |
| TalkBack + Android 版 Chrome | 触控驱动的 Android 行为、Android 虚拟导航,或 Android 专属差异。 |
| ID | 规则 |
|---|---|
| FR12 | 桌面中立性后续验证使用两个独立技术栈:Windows 上的 NVDA + Chrome 与 macOS 上的 VoiceOver + Safari。平台专属声明仅使用其匹配的配对,除非 FR14 扩展它。 |
| FR13 | 移动端后续验证使用匹配的移动技术栈。移动或触控/虚拟光标结果使用至少一个匹配的移动配对;仅当声明同时覆盖 iOS 与 Android、且有理由预期结果不同时,才同时使用二者。 |
| FR14 | 差异是扩展而非替代。已知差异中每一被指名的方面都会被纳入,即使这会增加超出 FR12 或 FR13 的配对。 |
| FR15 | 版本与模式是结果的一部分。测试记录须指明操作系统、AT、浏览器、输入模式,以及影响结果的实质性设置或详细程度。“已检查屏幕阅读器”或仅有浏览器名称而无其 AT,不构成矩阵。 |
| FR16 | 代表性不等于穷尽。通过所选配对仅支持已记录的结果与配对。它并不声称每种 AT、浏览器、详细程度设置、语言区域或输入方式的行为都相同。 |
合并、发布与后续跟进¶
| ID | 规则 |
|---|---|
| FR17 | 合并与发布仅需要可生成的证据。一旦其所属记录所要求的单元、DOM、无障碍树、axe 和真实浏览器证据全部通过,变更即可合并到 main 并随稳定版本发布。待处理、缺失或尚未运行的真实 AT 观察结果 MUST NOT 阻止合并或稳定版本发布,任何记录都不得将其设为门禁条件。 |
| FR18 | 后续跟进会被跟踪,而不会被阻塞。建议的真实 AT 后续跟进可以在公开 issue 中跟踪,注明声明、场景和配对组合。该 issue 不阻塞任何拉取请求或发布。 |
| FR19 | 在真实 AT 不可用时,由较低层级设定标准。公告声明在合并时由 FR4 证据满足。焦点暴露、模式和虚拟光标声明由观测最接近可生成状态的无障碍树与真实浏览器证据满足。该证据 MUST NOT 被描述为证明了语音、时序或光标位置。 |
| FR20 | 失败仍然是发现项。失败的真实 AT 观察结果是缺陷:它记录用户影响并关联修复,并像任何其他缺陷一样处理。将预期结果修改为匹配不良观察结果并不会让失败变成通过。 |
| FR21 | 凭据在失效前始终有效。当被测试的语义、焦点、公告、虚拟光标或差异敏感路径以及相关支持声明保持不变时,通过状态的凭据仍然可用。对该路径的实质性更改、针对已观察行为的修复或新记录的差异都会使其失效。无关的提交不会。 |
| FR22 | 失效凭据会被标记。当后续更改使凭据失效时,跟踪记录会注明这一点,后续跟进恢复为建议状态。这是信息,而非门禁条件。 |
持久凭据与证据存储¶
| ID | 规则 |
|---|---|
| FR27 | 文本凭据持久且公开。当真实 AT 检查运行时,其规范凭据位于已合并的拉取请求、关联的公开跟踪 issue 或仓库自有记录中。它 MUST 保持可读,无需依赖即将过期的 CI 产物、私有系统或未纳入版本控制的本地文件。 |
| FR28 | 每份凭据都是可复现的。它记录源拉取请求及提交或已测试的构建标识符;稳定的 story、fixture、路由或精确复现步骤;被测声明;预期的焦点目标、语义、公告、时序或虚拟光标结果;操作系统、AT、浏览器及相关设置/版本;输入序列和起始状态;观察结果,包括适用的公告文本或焦点/光标目标;pass 或 fail、测试者和日期;以及适用的关联缺陷或后续跟进。 |
| FR29 | 文本承载决策关键事实。截图、录制内容、语音日志和 CI 产物可以作为凭据的补充。它们 MUST NOT 成为记录配对组合、预期结果、观察结果或结果的唯一载体。证据不得包含私人用户数据或仅限内部的链接。 |
| FR30 | 可复用场景与代码一同存放。当某个场景会被复用或代表组件契约时,其稳定的 story 或 fixture 会检入仓库。一次性外部测试页面不是唯一的复现路径。 |
| FR31 | 指南以本规范为基准。未来的贡献者无障碍指南链接到本规范,以进行后续分类、证据边界和接收要求。未来的发布指南链接到本规范,以确定合并与发布的证据标准。这些指南可以解释当前工作流,但不得(MUST NOT)重复或重新定义本政策。 |
平台支持¶
- 支持的功能/引擎最低标准:AST-013 以及受影响组件或包自身的浏览器支持。后续配对在该支持声明范围内选择。
- 不支持的行为:未测试的配对不作出通过性声明;已知支持配对差异遵循 FR6 和 FR14。
- 浏览器证据:Playwright 或其他真实浏览器运行器证明浏览器行为和辅助功能树暴露。只有当实际指定的辅助技术针对指定浏览器运行时,才是真实辅助技术(real-AT)证据。
当前状态影响¶
-
早期记录的稳定发布持有项,包括只读 Popover 初始焦点和 CommandPalette 空结果公告,被推荐为后续处理项。其已检入场景(
Read-only dialog focus;CommandPalette / Audit Matrix)和配对在真实辅助技术(real-AT)运行中仍然有效,且不阻塞任何发布。 -
spec:AST-086状态公告修复基于 FR4 证据(FR17、FR19)合并。 spec:AST-001、spec:AST-020、spec:AST-021、spec:AST-056、spec:AST-086、component:FieldStatus、module:Table/useTableRowStatus和module:Table/useTableColumnResize将真实辅助技术观察描述为推荐后续项,而非合并或发布要求。- 没有任何贡献记录拥有辅助技术验证。当创建此类记录时,它链接回
spec:AST-009,而不是复制其政策。
验证¶
| 契约 | 验证 | 代表性状态 | 变更或失败预期 |
|---|---|---|---|
| FR1–FR8 | 对照变更所声称的用户结果进行分类审查。 | 静态语义修复;仅浏览器焦点变化;AT 公告的自动聚焦;实时更新;虚拟光标进入;已知差异 | 依赖 AT 的声明在缺少其底层证明的情况下发布,或无关的无障碍修复被送往 real-AT 后续处理。 |
| FR9–FR11 | 证据映射审查加定向测试/观察。 | 单元状态;DOM 属性;计算树;axe 状态;浏览器焦点;语音/盲文结果 | 较低层级被赋予其无法观察到的语音、时序、光标或互操作性。 |
| FR12–FR16 | 在 real-AT 接收单中命名的配对。 | 桌面中性;平台特定;移动端;已知差异堆栈 | 通用的“已检查屏幕阅读器”结果替代了所需的独立或差异配对。 |
| FR17–FR22 | 合并与发布审查。 | 带 FR4 证据的公告修复;待处理的后续问题;real-AT 观察失败;过期接收单 | 拉取请求或发布等待 real-AT 证据,或较低层级证明被描述为证明语音。 |
| FR27–FR31 | 接收单完整性和链接持久性审查。 | PR 接收单;关联问题;可复用的已检入 fixture;补充录制 | 关键证据仅存在于已过期/私有工件中、无法复现,或指南偏离本政策。 |
完成标准¶
一项变更在满足以下条件时符合本政策:
- 在 FR8 下命名了一个依赖 AT 的声明;
- 每个声明都有来自可生成层的证据,该层可在 FR4、FR9–FR11 和 FR19 下对该声明进行观察;
- 在 FR17 下,没有任何合并或发布等待真实 AT 观察;以及
- 任何已存在的真实 AT 凭证在 FR27–FR29 下都是持久且可复现的。
决策日志¶
DEC-1 — 真实 AT 跟进由结果触发,而非按类别全面触发¶
参考: spec:AST-009/DEC-1 · 决策者: cixzhang,2026-08-31
决策: FR1–FR8 建议针对 AT 特定的焦点暴露/顺序、通告行为、虚拟光标进入或已知分歧进行真实 AT/浏览器跟进。焦点目标、键盘行为、焦点外观及其他可访问性变更,使用直接支持其声明的证据和权威依据。
用户影响理由: 依赖 AT 的结果获得有针对性的关注,而不会让无关的变更进行昂贵且浅层的检查。已拒绝: 对每一项可访问性变更都运行全部 AT。
DEC-2 — 证据层保持各自不同的证明边界¶
参考: spec:AST-009/DEC-2 · 决策者: cixzhang,2026-08-31
决策: 单元、DOM、无障碍树、axe、浏览器和真实 AT 证据各自证明不同的边界。变更组合所需的层,而不是将某一种工具视为普遍适用的可访问性证明。
用户影响理由: 人们必须获得听到或导航到的结果,而不仅仅是表面上合理的标记或一次通过的自动化检查。已拒绝: 将一次通过的 axe 运行、看似合理的 ARIA 或可访问性快照,描述为能证明一个人听到了什么或他的虚拟光标进入了哪里。
DEC-3 — 真实 AT 矩阵具有代表性且针对具体声明¶
参考: spec:AST-009/DEC-3 · 决策者: cixzhang,2026-08-31
决策: 桌面中立的跟进使用 Windows 上的 NVDA + Chrome,以及 macOS 上的 VoiceOver + Safari。移动端、平台特定及已知存在分歧的声明,会根据受影响的结果选择或扩展该矩阵。通过的结果不构成通用兼容性声明。
用户影响理由: 这些配对覆盖了相关声明,而不会暗示未测试过的 AT、浏览器、详细程度、区域设置或输入行为。已拒绝: 为每项变更设置一个固定的穷尽矩阵,或用一个方便的配对来代表一组已知行为迥异的组合。
DEC-4 — 真实 AT 证据绝不阻断合并或发布¶
参考: spec:AST-009/DEC-4 · 决策者: cixzhang,2026-10-22
决策: 合并和稳定发布仅要求 Astryx 能够产出的证据。DOM、无障碍树、axe 和真实浏览器证据设定了基线;真实 AT 观察是建议的后续跟进(FR17–FR19)。
用户影响理由: 如果一项要求没有贡献者能够满足,就会拖延那些消除已知可访问性缺陷的修复,从而让这些缺陷在用户面前存在更长时间。已拒绝: 在指定的真实 AT 凭证通过之前,暂缓稳定发布。
DEC-5 — 真实 AT 凭证在变更边界上保持持久¶
参考: spec:AST-009/DEC-5 · 决策者: cixzhang,2026-08-31
决策: 当执行真实 AT 检查时,相关变更或关联的跟踪记录会携带一份可复现的文本凭证,其中包含构建标识和结果。会过期的工件可以作为补充,但不能独自承载其中的事实。
用户影响理由: 未来的贡献者和维护者可以审计观察到了什么、在哪个构建上进行的观察。已拒绝: 将私人笔记、本地文件或临时的 CI 工件作为唯一记录。
开放问题¶
无。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx