Модалки без библиотеки в 2026dialog, popover и то, что ещё пишем сами
Браузер научился сам держать фокус, закрывать окно по Esc и рисовать подложку. Разбираем, какую часть кода модалок можно удалить и что остаётся на нас.
- Раздел
- JavaScript
- Стек
- HTMLJavaScriptCSSa11y
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 7 мин
- Для модального окна берите dialog и showModal(): остальная страница становится inert сама.
- Для меню, подсказок и выпадашек подходит атрибут popover с popovertarget, даже без JS.
- Esc, верхний слой и подложка ::backdrop работают из коробки, z-index больше не нужен.
- Блокировку прокрутки, анимацию закрытия и позиционирование всё ещё дописываем сами.
- Заменить div-модалку на dialog и открывать через showModal()
- Стилизовать подложку через ::backdrop вместо отдельного оверлея
- Меню и подсказки перевести на popover и popovertarget
- Удалить самописные ловушки фокуса и обработчики Esc
- Добавить блокировку прокрутки и анимацию через CSS
Сколько кода было в обычной модалке#
Ещё несколько лет назад модальное окно в любом проекте выглядело одинаково: div с классом, второй div под ним в роли затемнения, z-index: 9999 и полсотни строк JavaScript. Эти строки ловили клавишу Esc, запоминали элемент, с которого открыли окно, держали фокус внутри через перехват Tab, ставили aria-hidden на всё остальное и снимали его обратно. Ошибка в любом пункте превращала модалку в ловушку для пользователя клавиатуры.
Часть этих задач мы решали делегированием событий, как в заметке про делегирование событий в JavaScript: один обработчик на документ, который закрывает окно по клику на подложку. Приём хороший, но сам по себе он не делает окно доступным.
Сейчас у браузера есть два встроенных механизма. Элемент <dialog> отвечает за настоящие модальные окна, а глобальный атрибут popover за всё, что всплывает поверх страницы и не должно блокировать её: меню, подсказки, выпадающие списки, уведомления. Оба используют верхний слой (top layer), поэтому войну с z-index можно закончить.
dialog и showModal(): модальное окно без ловушек фокуса#
У <dialog> два способа открытия. Метод show() показывает немодальное окно, с остальной страницей можно продолжать работать. Метод showModal() делает то, что мы раньше писали руками: выносит окно в верхний слой, делает всё остальное недоступным (как будто на страницу поставили атрибут inert), переводит фокус внутрь и закрывает окно по Esc. Перед закрытием по Esc приходит событие cancel, его можно отменить, если в форме несохранённые данные.
<button type="button" id="open-delete">Удалить проект</button>
<dialog id="confirm-delete" aria-labelledby="cd-title">
<form method="dialog">
<h2 id="cd-title">Удалить проект?</h2>
<p>Действие нельзя отменить.</p>
<button value="cancel" autofocus>Отмена</button>
<button value="confirm">Удалить</button>
</form>
</dialog>
<script>
const dlg = document.getElementById('confirm-delete');
document.getElementById('open-delete')
.addEventListener('click', () => dlg.showModal());
dlg.addEventListener('close', () => {
if (dlg.returnValue === 'confirm') deleteProject();
});
</script>Обратите внимание на method="dialog": такая форма не уходит на сервер, а закрывает окно и записывает value нажатой кнопки в dialog.returnValue. Атрибут autofocus выбирает, куда попадёт фокус при открытии; для деструктивных действий разумно ставить его на безопасную кнопку. Если autofocus нет, фокус уходит на первый фокусируемый элемент. После закрытия браузер возвращает фокус на кнопку, которая окно открыла. Ставить tabindex на сам <dialog> в документации не советуют.
Ещё одна деталь, которую раньше легко было забыть: модалка, открытая через showModal(), получает от браузера aria-modal="true", а немодальная через show() нет. Скринридеры понимают, что за пределами окна ничего читать не нужно, и нам не приходится вручную расставлять aria-hidden на соседей. Закрыть окно из кода можно методом close(value): переданное значение попадёт в тот же returnValue, что удобно для кнопок вне формы.
::backdrop и закрытие по клику снаружи#
Отдельный оверлей больше не нужен. Подложку под модальным окном рисует псевдоэлемент ::backdrop, а состояние окна удобно ловить псевдоклассами :modal и [open].
dialog::backdrop {
background: rgb(15 23 42 / 0.6);
backdrop-filter: blur(2px);
}
/* прокрутку страницы браузер не блокирует, делаем это сами */
html:has(dialog:modal) {
overflow: hidden;
}Закрытие по клику мимо окна долго было ручным: проверяли, что event.target совпадает с самим dialog, ведь клик по подложке приходит именно ему. Теперь есть атрибут closedby. Значение any разрешает закрытие кликом снаружи и по Esc, closerequest только по Esc и из кода, none только из кода. Поддержка у closedby пока не во всех браузерах, поэтому старую проверку по event.target мы оставляем как запасной путь.
Последняя строка CSS выше использует :has(): пока открыто модальное окно, корень документа не прокручивается. Подробнее про такие селекторы родителя в посте про :has() и container queries.
Атрибут popover: меню и подсказки без JavaScript#
Немодальные всплывающие элементы закрывает Popover API. Достаточно добавить атрибут popover элементу и связать с ним кнопку через popovertarget:
<button popovertarget="user-menu">Профиль</button>
<div id="user-menu" popover>
<a href="/">Настройки</a>
<button popovertarget="user-menu" popovertargetaction="hide">Закрыть</button>
</div>Всё, что дальше, браузер делает сам. У атрибута три значения:
- auto (значение по умолчанию): «лёгкое закрытие» по клику снаружи и по Esc, при открытии одного такого popover другие закрываются, кроме вложенных.
- manual: закрывается только явно, кнопкой или методом
hidePopover(). Подходит для уведомлений-тостов. - hint: для подсказок, которые не должны закрывать уже открытое меню. Это значение появилось позже, проверяйте поддержку.
Из JavaScript доступны showPopover(), hidePopover() и togglePopover(), а события beforetoggle и toggle сообщают о смене состояния. Для стилей открытого элемента есть псевдокласс :popover-open. Важное отличие от модалки: popover не делает страницу inert и не держит фокус. Это правильно для меню, но значит, что подтверждение удаления или форма оплаты должны жить в <dialog>.
Что всё ещё пишем руками#
Встроенные механизмы закрывают самую рискованную часть, но не всю работу. По нашему опыту миграции остаётся вот что:
- Блокировка прокрутки. Браузер её не делает, хватает одного правила с
:has(), как выше. - Анимация закрытия. Элемент получает
display: noneмгновенно. Для плавного исчезновения нужныtransition-behavior: allow-discreteи@starting-style; без них анимируется только появление. Не забывайте проprefers-reduced-motion, об этом пост про плавность в 2026. - Позиционирование popover. По умолчанию он открывается по центру экрана. Привязка к кнопке через CSS anchor positioning удобна, но поддержка ещё неравномерна, поэтому держим запасной вариант на JavaScript.
- Доступное имя.
aria-labelledbyна<dialog>и понятная кнопка закрытия по-прежнему на нас. - Проверка поддержки. Для старых браузеров достаточно условия
'popover' in HTMLElement.prototypeи упрощённого поведения.
Мигрировать проект мы советуем по одному компоненту. Сначала диалоги подтверждения: они простые, а выигрыш по доступности самый заметный. Затем выпадающие меню и подсказки на popover. В конце сложные окна с формами и вложенными слоями. После каждого шага проходим сценарий только с клавиатуры: открыть, пройти Tab по всем полям, закрыть Esc, убедиться, что фокус вернулся на кнопку. Такой ручной тест занимает минуту и ловит больше ошибок, чем автоматическая проверка.
Что изменилось к 2026 году#
Элемент <dialog> доступен во всех основных браузерах с 2022 года, Popover API по данным MDN вошёл в Baseline в 2025-м. Значит, для нового проекта самописная модалка уже скорее долг, чем решение. Библиотеки диалогов при этом не исчезли, но всё чаще превращаются в тонкие обёртки над нативными элементами.
Параллельно развиваются декларативные «команды»: атрибуты command и commandfor на кнопке позволяют открыть <dialog> как модалку без единой строки JavaScript. Поддержка у них свежая, поэтому в продакшене мы пока дублируем их обработчиком клика. Старые приёмы из раздела JavaScript не устарели целиком: делегирование событий и аккуратная работа с фокусом пригодятся внутри окон, просто сами окна стали проще.
«Лучший код модалки тот, который больше не нужно писать: фокус, Esc и подложку браузер уже умеет сам.»
Главный вывод заметки


