Почему модальное окно ломает фокус клавиатуры — и как это чинится одним тегом

Симптом узнаваемый. Модалка открылась, выглядит идеально. Ты нажимаешь Tab — и рамка фокуса уходит куда-то за затемнение, гуляет по ссылкам страницы под окном. Esc не закрывает. А когда окно всё-таки закрывается, фокус оказывается в начале документа.
Мышкой при этом всё работает безупречно, поэтому баг легко не заметить.
Это не мелочь: в опросе WebAIM «интерактивные элементы вроде меню, вкладок и диалогов, которые ведут себя не как ожидается» — вторая по болезненности проблема из всех, сразу после капчи. Хорошая новость: три причины покрывают почти все случаи, и первая чинится одним тегом.
Причина 1. Это не диалог, а просто блок поверх страницы
Самая частая, и почти обязательная в сгенерированном коде. Модалка сделана так:
<div class="modal">…</div>
Визуально — модальное окно: затемнение, тень, центр экрана. Для браузера — обычный блок, который нарисован сверху. Страница под ним живая: её ссылки и кнопки по-прежнему в порядке обхода Tab, и клавиатура спокойно уходит туда. То, что глазами это «закрыто», — иллюзия, созданная затемнением.
Как проверить: открой модалку и жми Tab, не отрывая глаз от экрана. Если рамка фокуса исчезла из окна — ты нашёл эту причину. Если рамки не видно вообще, сначала поищи в стилях outline: none.
Как починить. В HTML есть готовый элемент, который делает всю работу:
<dialog id="d">
<h2>Подтверди удаление</h2>
<button autofocus>Отмена</button>
</dialog>
document.getElementById('d').showModal();
Именно showModal(), а не show() и не атрибут open. За эту одну строку браузер сам даёт:
- всю остальную страницу делает неактивной (
inert) — Tab туда не уходит; - закрытие по Esc;
- перевод фокуса внутрь окна при открытии;
- корректное объявление для программ чтения с экрана.
Тонкость, на которой спотыкаются: show() и атрибут open открывают немодальное окно. Выглядит так же, ведёт себя как обычный блок — Esc не работает, страница позади активна. Если ты уже используешь <dialog>, но фокус течёт — почти наверняка дело в этом.
Причина 2. Фокус не переехал внутрь при открытии
Окно появилось, но фокус остался на кнопке, которая его открыла, — где-то в глубине страницы. Человек со скринридером вообще не узнает, что что-то произошло: он продолжает слушать старое место.
Как проверить: открой модалку с клавиатуры (Enter на кнопке) и, ничего больше не нажимая, посмотри, где рамка фокуса. Должна быть внутри окна.
Как починить: поставь autofocus на тот элемент, с которым человек будет взаимодействовать первым. В диалоге подтверждения — на безопасную кнопку («Отмена»), а не на «Удалить». Если содержимое длинное и начало важно прочитать, дай tabindex="-1" заголовку окна и сфокусируй его — тогда текст будет озвучен с начала.
Не вешай tabindex на сам <dialog>: он не интерактивен и фокус принимать не должен.
Причина 3. Фокус не вернулся после закрытия
Самая забываемая. Ты закрыл окно — и оказался в начале страницы. Для мыши это незаметно, для клавиатуры это катастрофа: человек нажал «Удалить» в списке из сорока элементов и был выброшен в шапку сайта.
Правило простое: когда диалог закрывается, фокус возвращается на тот элемент, который его открыл. Исключение одно — если этого элемента больше нет: удалил строку — верни фокус в осмысленное место, например на следующую строку списка.
Как починить: запомни активный элемент перед открытием и верни фокус после закрытия.
let opener;
btn.addEventListener('click', () => { opener = document.activeElement; d.showModal(); });
d.addEventListener('close', () => opener?.focus());
Три строки. Именно их почти никогда нет в сгенерированном коде — потому что визуально всё и так работает.
Проверка за минуту: четыре нажатия
Порядок такой, что каждая причина всплывает по очереди. Мышь при этом не трогай вообще — весь баг живёт только на клавиатуре.
- Дойди до кнопки открытия по Tab и нажми Enter. Модалка открылась? Смотри, где рамка фокуса — это причина 2.
- Жми Tab по кругу, раз десять. Фокус обязан ходить только внутри окна и после последнего элемента возвращаться на первый. Ушёл наружу — причина 1.
- Нажми Esc. Не закрылось — почти наверняка тоже причина 1: у тебя не модальный диалог.
- Посмотри, где фокус после закрытия. Не на кнопке, которая открывала, — причина 3.
Если все четыре шага прошли — окно нормальное. Обычно с первого раза проходит один из четырёх.
Ещё две мелочи, которые стоит проверить
- Видимая кнопка закрытия внутри окна. Не только крестик, нарисованный в углу псевдоэлементом, а настоящая кнопка в порядке обхода. Esc — не единственный путь наружу.
- Имя у окна. Заголовок связывают с окном через
aria-labelledby, тогда при открытии озвучивается «диалог, Подтверди удаление», а не просто «диалог».
Почему баг не видно при обычном тестировании?
Потому что мышью он не воспроизводится: клик всегда попадает туда, куда целишься. Он живёт только на клавиатуре. Быстрая проверка — пройти сценарий скринридером или просто убрать руку с мыши.
Можно ли обойтись без <dialog>?
Можно, но придётся вручную повторить всё то, что он даёт: пометить фон атрибутом inert, зациклить Tab внутри окна, обработать Esc, перевести и вернуть фокус. Готовые библиотеки это умеют — но начинать стоит со встроенного элемента.
А если модалок открыто несколько?
Esc должен закрывать только последнюю открытую, а не все сразу. При использовании <dialog> браузер делает это сам — ещё один аргумент не изобретать своё.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





