docs: accessibility audit for framework tracker

未关闭
#761 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
48/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
playwright, typescript

调研方向

Start by reviewing the component tests mentioned in #759 and how the built site and CI are configured. The issue suggests running @axe-core/playwright across built pages, then manually checking chart alternatives, screen reader tables, keyboard access to tooltips and controls, and both themes. Done means agreeing on an audit approach and fixing or triaging the findings; no specific files or completion criteria are named.

由索引模型根据 Issue 内容生成。

描述

enhancement research

suggestion: it might be worth doing a proper accessibility audit of the site at some point.

astro's dev toolbar already has an audit app that flags a11y issues while you browse in dev, which is nice, but it only covers the surface: a limited set of rules, only on the page you have open, and only while running astro dev. the component tests from #759 also run axe, but on each component on its own, so they miss things you only get on real pages like landmarks and headings, colour contrast with the actual theme, or the charts once they're mounted in context.

a few ideas on how we could approach it:

  • run axe (@axe-core/playwright) over every page of the built site in ci, so issues show up on prs instead of whenever someone opens the toolbar
  • go through what it finds and fix or triage it
  • do a manual pass on what tools can't judge: text alternatives for the charts, the screen reader tables, keyboard access to tooltips and the chart controls, both themes

automated checks only catch part of wcag issues, so the manual pass is probably where most of the value is. open to other ideas or tools if anyone has experience with this.

主要语言
TypeScript
星标
42
派生
16
平均合并
12 小时 36 分钟
30 天内合并 PR
151

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

e18e/framework-tracker 的其他 Issue

查看 e18e/framework-tracker 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。