Collapsible list: unlabeled accessible button, decorative image

未关闭适合新手

#2,811 创建于 2026年6月1日 0 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 2/5
预计耗时: 1-3 小时
新手友好度: 68/100

Issue 类型: 缺陷
描述清晰度: 基本清楚
活跃度: 冷清
技术栈: react, typescript
领域: accessibility, frontend

调研方向

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

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

描述

a11y

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 💖

主要语言: TypeScript
星标: 10.2k
派生: 772
平均合并: 6 天 6 小时
30 天内合并 PR: 25

贡献指南

打开贡献指南

从这里开始

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

TypeCellOS/BlockNote 的其他 Issue

openSuggestionMenu: menu closes on the second typed character (single-transaction dispatch breaks queryStartPos) 未关闭

难度 2/5 1-3 小时新手友好度 82/100

TypeCellOS/BlockNote#2949 · 1 条评论 · 2026年8月6日创建
Improve placeholder and side menu icon contrast for WCAG compliance 未关闭

a11y

难度 2/5 1-3 小时新手友好度 68/100

TypeCellOS/BlockNote#2855 · 2026年6月15日创建
Keyboard workflow for deleting a table is not explained 未关闭

a11y

难度 2/5 1-3 小时新手友好度 62/100

TypeCellOS/BlockNote#2829 · 1 条评论 · 2026年6月4日创建
Comment thread actions: hover-only controls and unlabeled buttons in ThreadsSideba 未关闭

a11y

难度 2/5 1-3 小时新手友好度 72/100

TypeCellOS/BlockNote#2824 · 2026年6月4日创建
Markdown round trip turns URL links into plain text (no autolink parsing since 0.51) 未关闭

难度 3/5 1-2 天新手友好度 65/100

TypeCellOS/BlockNote#3114 · 2026年9月23日创建

查看 TypeCellOS/BlockNote 的全部 Issue

相似的 Issue

False positive: TurkScan.com / TurkChain network 未关闭

blocklist removal

难度 2/5 1-3 小时新手友好度 65/100

MetaMask/eth-phishing-detect#296544 · 2026年9月23日创建
Package recommendation for React inline SVG loaders 未关闭

难度 2/5 1-3 小时新手友好度 70/100

pastelsky/bundlephobia#1122 · 2026年9月23日创建
[Dashboard] Prevent opening the upstream list when its limit is off 未关闭

难度 2/5 1-3 小时新手友好度 70/100

Menci/Floway#533 · 2026年9月23日创建
save-artifact's isSameFile overwrite guard has no hard-link witness (follow-up from #11848) 未关闭

category/development priority/P2 scope/file-operations scope/testing type/enhancement

难度 2/5 1-3 小时新手友好度 75/100

QwenLM/qwen-code#12578 · 3 条评论 · 2026年9月23日创建
Enatega Customer and Rider app: Add-ons price is not visible to customer after order is placed. 未关闭

难度 2/5 1-3 小时新手友好度 75/100

Margaret-Petersen/grocery-delivery-app-for-ios#1334 · 2026年9月23日创建

更多 TypeScript Issue