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.