Missing alternative text field for images

未關閉
#2,822 3 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度
3/5
預估耗時
1-2 天
新手友好度
65/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
冷清
技術堆疊
react, typescript
領域
accessibility, frontend

研究方向

Start at the image editing panel and follow the image insertion flow in the Docs editor. Check how the caption value reaches the generated image element, then add the separate alternative-text value and verify that it is reflected in the alt attribute without replacing the caption.

由索引模型根據 Issue 內容生成。

描述

a11y
What’s broken?

When inserting an image in the Docs editor, no field allows providing alternative text. Only a caption is offered, which does not substitute for alternative text.

What did you expect to happen?

A dedicated alternative text field, distinct from the caption, must be available in the image editing panel. Its value must be reflected in the alt attribute of the generated element.

Steps to reproduce

Open a Docs document
Insert an image via / or the toolbar
Open the image editing panel
Notice that no alternative text field is available, only a caption field
Possible solution

Add an "Alternative text" field in the image editing panel, distinct from the caption field.
Additional context / Screenshots

The caption is visible content associated with the image; it does not replace alternative text, which is transmitted to assistive technologies and must describe the content or function of the image.

WCAG Criteria

Criterion 1.1: Does each informative image have alternative text?

Impact

A blind user navigating with a screen reader inserts an image and has no way to provide alternative text. The image will be rendered without accessible description for users relying on assistive technologies.

BlockNote version

0.51.4

主要語言
TypeScript
星號
10.2k
分支
772
平均合併
3 天 11 小時
30 天內合併 PR
17

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue，再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫，在一個分支上完成修改。
  4. 送出 Pull Request，並在描述裡引用這個 Issue 編號。

TypeCellOS/BlockNote 的其他 Issue

查看 TypeCellOS/BlockNote 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。