工作方法
A11y Audit 将无障碍工作分为扫描、修复和验证阶段。源代码包含 Python 扫描器与对比度检查器接口、严重程度分类,以及针对不同框架的修复参考资料。它可以帮助将笼统的无障碍改进请求转化为范围明确的元素清单和代码变更。
源代码描述了广泛的 WCAG 覆盖范围,但不应将代码扫描表述为完整的合规认证。键盘操作流程、屏幕阅读器行为、动态内容以及替代文本是否实用,仍需结合具体情境进行审查。其实际价值在于可追溯性:保留初始问题,应用适当的原生语义或样式变更,然后重新运行检查并测试实际交互。
预期交付物
- 按严重程度排序的无障碍问题报告
- 适合项目所用框架的修复前后代码
- 与初始问题的对比,以及仍需人工检查的项目清单
从任务简述到审查
- 01扫描明确的范围
确定所用框架及相关源代码路径。记录元素级问题,并区分扫描器检测结果与人工观察结果。
- 02修复底层交互
优先使用原生控件、有意义的标签和清晰可见的焦点,而不是不加区分地添加 ARIA 属性。
- 03在实际情境中验证
与基线进行比较,在渲染状态下检查对比度,并实际测试静态分析无法确认的键盘和辅助技术操作路径。