Как создать доступные модальные диалоги с HTML, CSS и JavaScript
Создайте доступные модальные диалоги, используя нативный элемент dialog HTML. Узнайте, как открывать и закрывать всплывающие окна, управлять фокусом клавиатуры, стилизовать затемнение и создавать диалоги подтверждения без использования JavaScript-библиотеки.
Как создать доступные модальные диалоги с помощью HTML, CSS и JavaScript
Посетитель нажимает кнопку на вашем сайте. Появляется всплывающее окно с формой, подтверждающим сообщением или дополнительной информацией.
Создать визуальное всплывающее окно легко. Заставить его правильно работать с клавиатурой, экранным считывателем и мобильным браузером — совсем другое дело.
Многие пользовательские реализации модальных окон полагаются на большие объёмы JavaScript для управления фокусом, блокировки взаимодействия со страницей и обработки клавиши Escape.
Современный HTML предлагает более простой подход: нативный элемент <dialog>.
Он обеспечивает большую часть поведения, ожидаемого от модального диалога, напрямую в браузере. Вы можете создать функциональное всплывающее окно с небольшим количеством HTML, CSS и JavaScript, не устанавливая фреймворк или плагин.
В этом уроке мы создадим повторно используемое модальное окно, оформим его, добавим диалог подтверждения и рассмотрим детали доступности, важные для реальных сайтов.
1. Чем модальный диалог отличается от обычного всплывающего окна?
Модальный диалог временно требует от посетителя взаимодействия с определённой частью интерфейса перед возвращением к основной странице.
Типичные примеры включают:
- Подтверждение удаления элемента.
- Отображение контактной формы.
- Запрос подтверждения перед выходом со страницы.
- Показ дополнительной информации о продукте.
- Редактирование настройки приложения.
Правильно реализованный модальный диалог должен делать свою цель понятной, предлагать очевидный способ закрытия и правильно управлять клавиатурным фокусом.
Нативный элемент <dialog> поддерживает как модальное, так и немодальное поведение.
| Метод | Поведение |
|---|---|
showModal() |
Открывает модальное окно и делает остальную часть документа инертной |
show() |
Открывает немодальный диалог |
close() |
Закрывает диалог |
method="dialog" |
Позволяет кнопке формы закрыть диалог |
Модальное поведение включает управление фокусом и клавиатурное взаимодействие, предоставляемые браузером.
2. Создайте свой первый HTML модальный диалог
Начнём с простого примера: кнопка, открывающая диалог с заголовком, текстом и кнопкой закрытия.
<button type="button" id="openDialog">
View delivery information
</button>
<dialog id="deliveryDialog"
aria-labelledby="deliveryTitle">
<h2 id="deliveryTitle">
Delivery information
</h2>
<p>
Orders are prepared within two business days.
You will receive a tracking link by email.
</p>
<form method="dialog">
<button type="submit" autofocus>
Close
</button>
</form>
</dialog>
<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');
openButton.addEventListener('click', () => {
dialog.showModal();
});
</script>
Этого достаточно для создания работающего модального диалога.
Когда посетитель нажимает кнопку, showModal() открывает диалог поверх содержимого страницы.
Браузер автоматически обрабатывает несколько важных поведений:
- Диалог переходит в верхний слой (top layer), выше обычного содержимого страницы.
- Остальная часть документа становится инертной.
- Клавиатурный фокус перемещается в диалог.
- Нажатие Escape обычно закрывает его.
- Фокус обычно возвращается к кнопке открытия при закрытии диалога.
Кнопка закрытия использует method="dialog", поэтому ей не нужен обработчик событий JavaScript.
3. Оформите диалог с помощью CSS
Диалог по умолчанию работает, но его внешний вид базовый.
Мы можем добавить скруглённые углы, комфортные отступы, адаптивную ширину и фоновый слой (backdrop).
dialog {
width: min(90vw, 520px);
max-height: 85vh;
box-sizing: border-box;
padding: 2rem;
border: 0;
border-radius: 14px;
background: #fff;
color: #20242b;
box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
overflow: auto;
}
dialog::backdrop {
background: rgba(15, 23, 42, .65);
backdrop-filter: blur(3px);
}
dialog h2 {
margin-top: 0;
font-size: 1.5rem;
}
dialog p {
line-height: 1.6;
}
dialog button {
padding: .75rem 1.25rem;
border: 0;
border-radius: 8px;
background: #2458d3;
color: #fff;
font: inherit;
cursor: pointer;
}
dialog button:focus-visible {
outline: 3px solid #f59e0b;
outline-offset: 3px;
}
Псевдоэлемент ::backdrop оформляет слой позади модального диалога.
Он появляется только когда диалог отображается модально, например, через showModal().
Диалог, открытый с помощью show(), не получает автоматически такое же поведение модального фонового слоя.
Зачем использовать верхний слой (top layer)?
Традиционные пользовательские всплывающие окна часто полагаются на всё более большие значения z-index.
Модальный диалог, открытый с помощью showModal(), попадает в верхний слой браузера, что избегает многих проблем с контекстом наложения (stacking context).
Это особенно полезно на сайтах с липкими заголовками (sticky headers), плавающими виджетами и сложными конструкторами страниц.
4. Поймите клавиатурную доступность
Модальное окно должно работать без мыши.
Представьте посетителя, навигирующего по вашему сайту с помощью клавиши Tab. Когда открывается модальное окно, он должен иметь возможность взаимодействовать с его элементами управления, не попадая случайно на страницу позади него.
Нативный модальный диалог помогает с этим поведением.
W3C описывает HTML-элемент dialog как технику создания доступных модальных диалогов, включая удержание фокуса и возврат фокуса при закрытии диалога.
Дайте диалогу доступное имя
Используйте видимый заголовок и сошлитесь на него с помощью aria-labelledby:
<dialog aria-labelledby="settingsTitle">
<h2 id="settingsTitle">Account settings</h2>
...
</dialog>
Это даёт вспомогательным технологиям осмысленное имя для диалога.
Тщательно выбирайте начальный фокус
Атрибут autofocus может указывать элемент управления, который должен получить фокус при открытии модального окна.
Для информационного диалога уместно может быть фокусирование кнопки закрытия.

Для формы может быть лучше фокусирование первого поля ввода.
Для подтверждения деструктивного действия часто предпочтительнее фокусирование более безопасного действия, такого как Cancel (Отмена).
Избегайте размещения tabindex непосредственно на элементе <dialog>; HTML-спецификация запрещает этот атрибут на самом элементе.
Всегда предоставляйте видимую кнопку закрытия
Даже если Escape обычно закрывает модальный диалог, видимый элемент управления закрытием остаётся необходимым.
Мобильные посетители могут не иметь физической клавиатуры, а некоторые пользователи не знают, что Escape может закрыть всплывающее окно.
5. Создайте диалог подтверждения с двумя кнопками
Теперь создадим более полезный пример: подтверждение удаления сохранённого элемента.
Посетитель должен иметь возможность выбрать Cancel (Отмена) или Delete (Удалить).
HTML предоставляет удобный механизм через method="dialog" и свойство returnValue диалога.
<button type="button" id="deleteItem">
Delete item
</button>
<dialog id="confirmDialog"
aria-labelledby="confirmTitle">
<h2 id="confirmTitle">
Delete this item?
</h2>
<p>
This action cannot be undone.
</p>
<form method="dialog">
<button value="cancel" autofocus>
Cancel
</button>
<button value="confirm">
Delete
</button>
</form>
</dialog>
<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');
deleteButton.addEventListener('click', () => {
confirmDialog.returnValue = 'cancel';
confirmDialog.showModal();
});
confirmDialog.addEventListener('close', () => {
if (confirmDialog.returnValue === 'confirm') {
// Call your application deletion logic here.
console.log('Deletion confirmed');
}
});
</script>
Важный момент: нажатие кнопки внутри формы method="dialog" закрывает диалог и устанавливает его returnValue.
Наш код проверяет, выбрал ли пользователь confirm.
Сброс значения перед открытием предотвращает ошибочное принятие более раннего подтверждения за новое, если пользователь закрыл диалог клавишей Escape.
Пример намеренно ничего не удаляет. В реальном приложении подтверждённое действие вызовет ваш собственный PHP-эндпоинт или контроллер приложения с необходимой авторизацией и защитой CSRF.
6. Протестируйте рабочий процесс подтверждения
Полезная демонстрация — список сохранённых элементов, у каждого из которых есть кнопка Delete. Нажатие Delete должно открыть диалог подтверждения. Cancel должен оставить элемент нетронутым; Confirm должен удалить только выбранный элемент.
Это иллюстрирует поток подтверждения без изменения реальных данных сайта.
7. Добавьте контактную форму внутри диалога
Контактная форма — ещё один распространенный вариант использования.
Но есть важное различие между закрытием диалога и отправкой данных на сервер.
Форма с method="dialog" закрывает всплывающее окно. Она не отправляет обычный HTTP-запрос на ваш PHP-бэкенд.
Для реальной контактной формы используйте обычную отправку формы или AJAX-запрос.
Например:
<dialog id="contactDialog"
aria-labelledby="contactTitle">
<h2 id="contactTitle">
Contact us
</h2>
<form action="/contact-handler.php" method="post">
<label for="contactEmail">
Your email
</label>
<input
type="email"
id="contactEmail"
name="email"
required
autocomplete="email"
autofocus
>
<label for="contactMessage">
Your message
</label>
<textarea
id="contactMessage"
name="message"
required
></textarea>
<button type="submit">
Send message
</button>
<button type="button" id="closeContact">
Cancel
</button>
</form>
</dialog>
Кнопка Send (Отправить) отправляет форму обычным способом.
Кнопка Cancel должна закрыть диалог без отправки:
document.getElementById('closeContact')
.addEventListener('click', () => {
document.getElementById('contactDialog').close();
});
Ваш PHP-обработчик всё равно должен валидировать отправленные данные, реализовывать защиту от спама и возвращать осмысленный ответ об успехе или ошибке.
Модальный диалог улучшает интерфейс; он не заменяет серверную безопасность форм.
8. Могут ли пользователи закрыть диалог, кликнув снаружи?
Многие сайты позволяют посетителям закрыть всплывающее окно, кликнув по его фоновому слою (backdrop).
Это поведение часто называют light dismiss (лёгкое закрытие).
Современный HTML включает атрибут closedby, который может указывать, может ли диалог быть закрыт через внешнее взаимодействие, запросы платформы на закрытие или явные элементы управления.
Например:
<dialog id="infoDialog" closedby="any">
<h2>More information</h2>
<p>Additional details appear here.</p>
<form method="dialog">
<button>Close</button>
</form>
</dialog>
Значение closedby="any" разрешает поведение light-dismiss в браузерах, которые его поддерживают.
Однако поддержку новых функций диалога следует проверять против ваших целевых браузеров. Базовые API showModal() и close() более широко распространены.
Для критических диалогов подтверждения случайное закрытие снаружи может быть нежелательным.
Во всех случаях сохраняйте видимый элемент управления закрытием или отменой.
9. Избегайте этих распространённых ошибок реализации

Открытие модального окна добавлением атрибута open
Этот код:
dialog.setAttribute('open', '');
не обеспечивает то же поведение, что и:
dialog.showModal();
Атрибут open отображает диалог немодально. Он не делает автоматически остальную часть документа инертной.
Используйте showModal(), когда вам нужно настоящее модальное окно.
Удаление атрибута open для закрытия модального окна
Избегайте ручного удаления атрибута open из активного модального окна.
Используйте:
dialog.close();
Это следует задуманному жизненному циклу и обеспечивает соответствующее поведение закрытия.
Использование ссылки вместо кнопки
Элемент управления, открывающий действие интерфейса, обычно должен быть кнопкой:
<button type="button">Open settings</button>
Используйте ссылки для навигации к другому ресурсу.
Забывание видимости фокуса
Пользователям, навигирующим с клавиатуры, нужна видимая индикация того, какой элемент управления активен.
Сохраняйте чёткий стиль :focus-visible вместо удаления браузерных контуров фокуса без замены.
Размещение диалога внутри скрытого контейнера
Если родительский контейнер скрыт, или если CMS динамически заменяет окружающую разметку, диалог может вести себя неожиданно.
Для интеграций с конструкторами страниц предпочитайте стабильный контейнер и убедитесь, что JavaScript выполняется после вставки диалога в документ.
10. Интеграция диалога в WordPress или Joomla
Вам не нужно создавать расширение только для использования нативного элемента диалога.
Для простого сайта интеграция состоит из трёх частей:
| Часть | Куда она идёт |
|---|---|
| HTML-разметка | Блок Custom HTML, модуль, шаблон или элемент конструктора страниц |
| CSS | Пользовательский CSS темы или шаблона |
| JavaScript | Область пользовательских скриптов темы/шаблона, дочерняя тема или надежное расширение для вставки кода, корректно обрабатывающее JavaScript |
WordPress
В WordPress вы можете разместить HTML в блоке Custom HTML (Пользовательский HTML), если ваша учётная запись и конфигурация редактора позволяют необходимую разметку.
Добавьте стили через поддерживаемый вашей темой механизм пользовательского CSS.
Для JavaScript используйте поддерживаемую темой область скриптов, дочернюю тему или надежное расширение для вставки кода, корректно обрабатывающее JavaScript.
Некоторые редакторы и конфигурации безопасности фильтруют элементы <script>. Не полагайтесь на то, что JavaScript, вставленный напрямую в блок контента, выполнится.
Joomla
В Joomla модуль Custom (Пользовательский) или редактор, позволяющий подходящую HTML-разметку, может содержать диалог.
Добавьте CSS в пользовательскую таблицу стилей вашего шаблона, например, user.css на сайте на базе Cassiopeia.
Разместите JavaScript в поддерживаемом шаблоном месте для пользовательских скриптов или через подходящее расширение.
В зависимости от настроенного редактора и текстовых фильтров Joomla может удалять определённые элементы или атрибуты при сохранении контента.
Если ваша разметка исчезает, проверьте конфигурацию редактора и фильтрации, а не многократно вставляйте тот же код.
Конструкторы страниц (Page builders)
Тот же принцип применяется к визуальным конструкторам страниц: используйте их возможности интеграции HTML, CSS и JavaScript.
Для динамически загружаемого контента инициализируйте прослушиватели событий только после существования соответствующих элементов.
Если страница содержит несколько диалогов, дайте каждому уникальный ID.
11. Протестируйте свой модальный диалог перед публикацией
Диалог, выглядящий правильно на десктопе, может всё равно иметь проблемы удобства использования.
Протестируйте его с мышью, клавиатурой и мобильным устройством.
| Тест | Ожидаемый результат |
|---|---|
| Клик по кнопке открытия | Диалог появляется |
| Нажатие Tab | Фокус остаётся внутри элементов управления модального окна |
| Нажатие Shift + Tab | Обратная клавиатурная навигация работает |
| Нажатие Escape | Диалог закрывается, когда это допускается |
| Клик по Close или Cancel | Диалог закрывается |
| Закрытие диалога | Фокус возвращается соответствующим образом |
| Открытие на мобильном | Контент остаётся читаемым и прокручиваемым |
| Отправка невалидной формы | Обратная связь валидации видима |
| Отправка валидной формы | Приложение корректно обрабатывает данные |
| Использование экранного считывателя | Диалог имеет понятное имя |
Техника WCAG H102 от W3C предоставляет полезное руководство для проверки нативного модального поведения.
12. Когда следует использовать диалог вместо плагина?
Нативный диалог особенно подходит для небольших, сфокусированных взаимодействий: подтверждений, информационных панелей и простых форм.
Для более сложных потребностей, таких как многошаговые мастера, продвинутые галереи или диалоги, глубоко интегрированные с рабочим процессом CMS, выделенный компонент или расширение может всё ещё быть более поддерживаемым вариантом.
Преимущество нативного подхода в том, что он предоставляет твёрдую поддерживаемую браузером базу без введения очередной JavaScript-зависимости.
Он также уменьшает объём пользовательского управления фокусом и клавиатурой, который вам нужно реализовывать самостоятельно.
Заключение: начните с встроенных возможностей браузера
Модальный диалог не должен требовать большую JavaScript-библиотеку.
Нативный HTML-элемент <dialog> предоставляет эффективную базу для доступных всплывающих окон, подтверждающих сообщений и форм.
С showModal(), close(), method="dialog" и несколькими CSS-правилами вы можете создать интерфейс, работающий во всех современных браузерах, استفодуя от встроенного поведения фокуса и клавиатуры.
Для WordPress, Joomla и пользовательских PHP-сайтов это может быть эффективной альтернативой установке ещё одного плагина для относительно простого взаимодействия.
Ключ — правильно использовать нативное поведение, предоставлять чёткие элементы управления и тестировать результат с реальными клавиатурными и мобильными взаимодействиями.