TypeCellOS / TypeCellOS/BlockNote
Keyboard workflow for deleting a table is not explained
还没有人认领这个 Issue。
- 主要语言
- TypeScript
- 星标
- 10.2k
- 派生
- 772
- 平均合并
- 3 天 11 小时
- 30 天内合并 PR
- 17
描述
What’s broken?
This issue was identified during the Docs accessibility audit on a page containing table-related content.
Audited page:
https://docs.numerique.gouv.fr/docs/0d998bef-1b69-47ce-bd18-83d4d849c734/
In the “Delete a table” block, the visual content explains how to delete a table using the mouse.
However, the keyboard workflow is different and is not clearly explained.
A keyboard-only user or screen reader user does not receive enough information to perform the same action without a mouse.
What did you expect to happen?
When an action is demonstrated with the mouse, the equivalent keyboard workflow should also be explained.
The documentation should clearly describe how to delete a table using the keyboard.
If the keyboard interaction is different from the mouse interaction, this difference should be explicitly documented.
Steps to reproduce
- Open the audited Docs document.
- Go to the “Delete a table” block.
- Review the visual explanation.
- Notice that the deletion workflow is explained through mouse interaction.
- Notice that the equivalent keyboard workflow is not clearly explained.
Impact
Keyboard-only users and screen reader users may not understand how to delete a table.
This creates an unequal experience where mouse users receive instructions, but keyboard users do not.
WCAG Criteria
WCAG 2.1.1 - Keyboard
WCAG 2.4.6 - Headings and Labels
BlockNote version
0.51.4
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从经过审计的 Docs 文档开始,找到“Delete a table”块。确定仅使用键盘以及使用屏幕阅读器时的操作流程,然后更新该块,明确说明这些步骤以及与鼠标操作的任何差异;当用户无需鼠标即可删除表格时,即视为完成。
由索引模型根据 Issue 内容生成。
评估
- 领域
- accessibility, documentation
- Issue 类型
- 文档
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 活跃度
- 冷清
- 描述清晰度
- 基本清楚
- 新手友好度
- 62/100