Як створити доступні модальні діалоги з 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(), не отримує автоматично ту саму поведінку модального фону.
Чому варто використовувати верхній шар?
Традиційні користувацькі спливаючі вікна часто покладаються на все зростаючі значення z-index.
Модальний діалог, відкритий за допомогою showModal(), потрапляє у верхній шар браузера, що уникає багатьох проблем зі стекуванням контекстів.
Це особливо корисно на веб-сайтах із фіксованими заголовками, плаваючими віджетами та складними конструкторами сторінок.
4. Зрозумійте клавіатурну доступність
Модальне вікно повинно працювати без миші.
Уявіть відвідувача, що навігує вашим веб-сайтом за допомогою клавіші Tab. Коли модальне вікно відкривається, він повинен мати можливість взаємодіяти з його елементами керування, не потрапляючи випадково на сторінку поза ним.
Нативний модальний діалог допомагає з цією поведінкою.
W3C описує HTML-елемент dialog як прийом для створення доступних модальних діалогів, включаючи обмеження фокусу та його повернення при закритті діалогу.
Дайте діалогу доступну назву
Використовуйте видимий заголовок та посилайтеся на нього за допомогою aria-labelledby:
<dialog aria-labelledby="settingsTitle">
<h2 id="settingsTitle">Account settings</h2>
...
</dialog>
Це дає допоміжним технологіям змістовну назву для діалогу.
Вибирайте початковий фокус обережно
Атрибут autofocus може визначати елемент керування, який повинен отримати фокус при відкритті модального вікна.
Для інформаційного діалогу доречно може бути фокусування на кнопці закриття.

Для форми краще сфокусуватися на першому полі вводу.
Для деструктивного підтвердження часто краще сфокусуватися на безпечнішій дії, наприклад, Скасувати.
Уникайте розміщення tabindex безпосередньо на елементі <dialog>; HTML-специфікація забороняє цей атрибут на самому елементі.
Завжди надавайте видиму кнопку закриття
Незважаючи на те, що Escape зазвичай закриває модальний діалог, видимий елемент керування закриттям залишається обов'язковим.
Мобільні відвідувачі можуть не мати фізичної клавіатури, а деякі користувачі не знають, що Escape може закрити спливаюче вікно.
5. Створіть діалог підтвердження з двома кнопками
Тепер створимо більш корисний приклад: підтвердження видалення збереженого елемента.
Відвідувач повинен мати можливість обрати Скасувати або Видалити.
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. Протестуйте робочий процес підтвердження
Корисною демонстрацією є список збережених елементів, кожен із кнопкою Видалити. Натискання Видалити має відкривати діалог підтвердження. Скасувати має залишити елемент незмінним; Підтвердити має видалити лише вибраний елемент.
Це ілюструє процес підтвердження без зміни реальних даних веб-сайту.
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>
Кнопка Надіслати відправляє форму зазвичай.
Кнопка Скасувати повинна закрити діалог без відправки:
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-розмітка | Блок користувацького HTML, модуль, шаблон або елемент конструктора сторінок |
| CSS | Користувацький CSS теми або шаблону |
| JavaScript | Область користувацьких скриптів теми/шаблону, дочірня тема або надійне розширення для вставки коду, яке коректно обробляє JavaScript |
WordPress
У WordPress ви можете розмістити HTML у блоці користувацького HTML, за умови, що ваш обліковий запис та конфігурація редактора дозволяють необхідну розмітку.
Додайте стилізацію через підтримуваний механізм користувацького CSS вашої теми.
Для JavaScript використовуйте підтримувану темою область скриптів, дочірню тему або надійне розширення для вставки коду, яке коректно обробляє JavaScript.
Деякі редактори та конфігурації безпеки фільтрують елементи <script>. Уникайте припущення, що JavaScript, вставлений безпосередньо в блок контенту, виконається.
Joomla
У Joomla користувацький модуль або редактор, що дозволяє відповідну HTML-розмітку, може містити діалог.
Додайте CSS до користувацького таблиці стилів вашого шаблону, наприклад, user.css у сайті на основі Cassiopeia.
Розмістіть JavaScript у підтримуваному шаблоном місці для користувацьких скриптів або через відповідне розширення.
Залежно від налаштованого редактора та текстових фільтрів, Joomla може видаляти певні елементи або атрибути при збереженні контенту.
Якщо ваша розмітка зникає, перевірте конфігурацію редактора та фільтрації, а не вставляйте той самий код повторно.
Конструктори сторінок
Той самий принцип застосовується до візуальних конструкторів сторінок: використовуйте їх можливості інтеграції HTML, CSS та JavaScript.
Для динамічно завантажуваного контенту ініціалізуйте обробники подій лише після існування відповідних елементів.
Якщо сторінка містить кілька діалогів, дайте кожному унікальний ID.
11. Протестуйте свій модальний діалог перед публікацією
Діалог, який виглядає правильно на десктопі, може все одно мати проблеми з користуваністю.
Протестуйте його з мишею, клавіатурою та мобільним пристроєм.
| Тест | Очікуваний результат |
|---|---|
| Клік по кнопці відкриття | Діалог з'являється |
| Натискання Tab | Фокус залишається в межах елементів керування модального вікна |
| Натискання Shift + Tab | Зворотна клавіатурна навігація працює |
| Натискання Escape | Діалог закривається, коли це дозволено |
| Клік закриття або скасування | Діалог закривається |
| Закриття діалогу | Фокус повертається відповідно |
| Відкриття на мобільному | Контент залишається читабельним та прокручуваним |
| Відправка невалідної форми | Валідаційний зворотний зв'язок видимий |
| Відправка валідної форми | Додаток коректно обробляє дані |
| Використання екранного читалка | Діалог має зрозумілу назву |
Техніка WCAG H102 від W3C надає корисні рекомендації для валідації нативної модальної поведінки.
12. Коли слід використовувати діалог замість плагіна?
Нативний діалог особливо підходить для невеликих, зосереджених взаємодій: підтверджень, інформаційних панелей та простих форм.
Для більш складних потреб, таких як багатоетапні майстри, розширені галереї або діалоги, глибоко інтегровані з робочим процесом CMS, спеціалізований компонент або розширення все ще може бути більш підтримуваним варіантом.
Перевага нативного підходу полягає в тому, що він забезпечує надійну фундацію, підтримувану браузером, без введення ще однієї JavaScript-залежності.
Він також зменшує кількість користувацького керування фокусом та клавіатурою, яке вам потрібно реалізувати самостійно.
Висновок: починайте з вбудованих можливостей браузера
Модальний діалог не обов'язково вимагає великої JavaScript-бібліотеки.
Нативний HTML-елемент <dialog> надає ефективну основу для доступних спливаючих вікон, повідомлень про підтвердження та форм.
За допомогою showModal(), close(), method="dialog" та декількох CSS-правил ви можете створити інтерфейс, який працює у сучасних браузерах, користуючись вбудованою поведінкою фокусу та клавіатури.
Для WordPress, Joomla та власних PHP-веб-сайтів це може стати ефективною альтернативою установці ще одного плагіна для відносно простої взаємодії.
Ключ — правильно використовувати нативну поведінку, надавати чіткі елементи керування та тестувати результат із реальними клавіатурними та мобільними взаємодіями.