TypeCellOS / TypeCellOS/BlockNote

Missing alternative text field for images

Aperta
#2,822 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

a11y
Lingua principale
TypeScript
Stelle
10.2k
Fork
772
Merge medio
3g 11h
PR unite (30g)
17

Descrizione

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

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
react, typescript
Ambito
accessibility, frontend
Tipo di issue
Funzionalità
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
65/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.