TypeCellOS / TypeCellOS/BlockNote

Collapsible list: unlabeled accessible button, decorative image

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

还没有人认领这个 Issue。

a11y
主要语言
TypeScript
星标
10.2k
派生
772
平均合并
3 天 11 小时
30 天内合并 PR
17

描述

What’s broken?

The button used to collapse/expand a collapsible list does not have an accessible name. The image it contains is not hidden from assistive technologies. As a result, the component is not vocalized and the user cannot identify the presence of a collapsible list in the document.

Impact

A blind user navigating with a screen reader cannot identify the collapsible list button. The component is unreachable: the user does not know that a collapsible list exists in the document and cannot interact with it.

What did you expect to happen?

The button must have an accessible name describing its action (for example "Collapse list" / "Expand list"). The decorative image contained in the button must be hidden from screen readers.

Steps to reproduce

Open a document containing a collapsible list in Docs.
Navigate with a screen reader.
Observe that the collapsible list button is not vocalized.

BlockNote version

0.51.1

Environment

No response

Additional context

No response

Contribution
  • I'd be interested in contributing a fix for this issue
Sponsor
  • I'm a sponsor and would appreciate if you could look into this sooner than later 💖

贡献指南

打开贡献指南

从这里开始

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

调研方向

从 Docs 中使用的可折叠列表按钮入手,使用屏幕阅读器检查其当前的无障碍行为。为按钮提供特定于操作的可访问名称,例如“折叠列表”或“展开列表”,将其装饰性图像对辅助技术隐藏,并验证折叠和展开两种状态。

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

评估

技术栈
react, typescript
领域
accessibility, frontend
Issue 类型
缺陷
难度
2/5
预计耗时
1-3 小时
活跃度
冷清
描述清晰度
基本清楚
新手友好度
68/100

把新 issue 发到你的邮箱

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