a11y: ModalDialog does not set aria-modal="true" on the dialog element

Aperta Adatta ai principianti
#4,402 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
react, typescript

Direzione di ricerca

Inizia in src/Modal/ModalDialog.tsx, sull’elemento role="dialog", quindi esamina i componenti derivati AlertModal, FullscreenModal e MarketingModal. Verifica come react-focus-on applica il comportamento aria-hidden. Il lavoro è completato quando il dialog espone aria-modal="true", i modal derivati lo ereditano e non c’è alcun conflitto dovuto a un doppio inert.

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

Descrizione

Context

Found during the 2026 Axim-commissioned accessibility audit of Paragon, while documenting ModalDialog against the APG modal dialog pattern.

Current behavior

ModalDialog renders the dialog container with role="dialog" and aria-label={title} (ModalDialog.tsx), and ModalLayer enforces focus containment behaviorally via react-focus-on. However, aria-modal="true" is not set.

Impact

Some screen readers use aria-modal to scope reading/browse commands to the dialog and treat background content as inert. Without it, users may be able to read (though not focus) background content while the dialog is open, contrary to the modal's intent. WCAG mapping: 4.1.2 Name, Role, Value (state not fully exposed).

Suggested fix

Add aria-modal="true" to the role="dialog" element in ModalDialog.tsx. Verify the derived modals (AlertModal, FullscreenModal, MarketingModal) inherit it, and confirm no double-inert conflict with the react-focus-on aria-hidden handling.

References

Lingua principale
JavaScript
Stelle
141
Fork
101
Merge medio
11h 13m
PR unite (30g)
44

Preparare l'ambiente

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.

Altre issue di openedx/paragon

Tutte le issue di openedx/paragon

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.