TypeCellOS / TypeCellOS/BlockNote
Collapsible list: unlabeled accessible button, decorative image
还没有人认领这个 Issue。
- 主要语言
- 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 💖
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从 Docs 中使用的可折叠列表按钮入手,使用屏幕阅读器检查其当前的无障碍行为。为按钮提供特定于操作的可访问名称,例如“折叠列表”或“展开列表”,将其装饰性图像对辅助技术隐藏,并验证折叠和展开两种状态。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- react, typescript
- 领域
- accessibility, frontend
- Issue 类型
- 缺陷
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 活跃度
- 冷清
- 描述清晰度
- 基本清楚
- 新手友好度
- 68/100