TypeCellOS / TypeCellOS/BlockNote

Keyboard workflow for deleting a table is not explained

未关闭 适合新手
#2,829 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

a11y
主要语言
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
  1. Open the audited Docs document.
  2. Go to the “Delete a table” block.
  3. Review the visual explanation.
  4. Notice that the deletion workflow is explained through mouse interaction.
  5. 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

贡献指南

打开贡献指南

从这里开始

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

调研方向

从经过审计的 Docs 文档开始,找到“Delete a table”块。确定仅使用键盘以及使用屏幕阅读器时的操作流程,然后更新该块,明确说明这些步骤以及与鼠标操作的任何差异;当用户无需鼠标即可删除表格时,即视为完成。

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

评估

领域
accessibility, documentation
Issue 类型
文档
难度
2/5
预计耗时
1-3 小时
活跃度
冷清
描述清晰度
基本清楚
新手友好度
62/100

把新 issue 发到你的邮箱

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