Kategoria: Next.js, React i TypeScript

React: modal przez portal gubi fokus klawiatury

Poradnik techniczny · Kacper Bernecki

Po otwarciu okna dialogowego Tab przechodzi do elementów pod modalem, a Escape nie zamyka okna. Przeniesienie DOM przez createPortal nie dostarcza automatycznie pełnego mechanizmu dostępności dialogu.

Jak rozpoznać źródło problemu

Sprawdź rolę dialog, aria-modal, etykietę i kolejność fokusu po otwarciu. Zbadaj, czy w tle wciąż da się aktywować elementy klawiaturą lub czy fokus znika po zamknięciu.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Użyj natywnego dialog lub biblioteki zapewniającej focus trap, obsługę Escape i prawidłowy powrót fokusu. Zablokuj interakcję z tłem podczas modalnego dialogu, a po zamknięciu ustaw fokus na przycisk otwierający.

Jak przetestować rozwiązanie

Nawigacja Tab pozostaje w otwartym modalnym oknie, a Escape zamyka je i zwraca fokus.

Bezpieczeństwo i ograniczenia

Nie traktuj samego wysokiego z-index jako zapewnienia dostępności modalnego interfejsu.