TypeCellOS / TypeCellOS/BlockNote

Keyboard workflow for deleting a table is not explained

Aperta Adatta ai principianti
#2,829 1 commento 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?

This issue was identified during the Docs accessibility audit on a page containing table-related content.

Audited page:
https://docs.numerique.gouv.fr/docs/0d998bef-1b69-47ce-bd18-83d4d849c734/

In the “Delete a table” block, the visual content explains how to delete a table using the mouse.

However, the keyboard workflow is different and is not clearly explained.

A keyboard-only user or screen reader user does not receive enough information to perform the same action without a mouse.

What did you expect to happen?

When an action is demonstrated with the mouse, the equivalent keyboard workflow should also be explained.

The documentation should clearly describe how to delete a table using the keyboard.

If the keyboard interaction is different from the mouse interaction, this difference should be explicitly documented.

Steps to reproduce
  1. Open the audited Docs document.
  2. Go to the “Delete a table” block.
  3. Review the visual explanation.
  4. Notice that the deletion workflow is explained through mouse interaction.
  5. Notice that the equivalent keyboard workflow is not clearly explained.

Impact

Keyboard-only users and screen reader users may not understand how to delete a table.

This creates an unequal experience where mouse users receive instructions, but keyboard users do not.

WCAG Criteria

WCAG 2.1.1 - Keyboard
WCAG 2.4.6 - Headings and Labels

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

Inizia dal documento Docs sottoposto ad audit e individua il blocco «Delete a table». Determina il flusso di lavoro usando solo la tastiera e con uno screen reader, quindi aggiorna il blocco in modo che questi passaggi e qualsiasi differenza rispetto all’interazione con il mouse siano espliciti; il lavoro è completato quando gli utenti possono eliminare una tabella senza mouse.

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

Valutazione

Ambito
accessibility, documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
62/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.