Сначала посмотрите не на CSS, а на фактическое состояние элемента. Для нативного <dialog> свойство open после закрытия должно стать false и затем срабатывает событие close. Если open уже false, но экран всё ещё затемнён, остался отдельный backdrop или класс блокировки страницы.
Не начинайте с принудительного удаления узла из DOM: так легко потерять фокус, незавершённую форму и cleanup. Поставьте короткий журнал на open, cancel, close и кнопку, воспроизведите один способ закрытия и найдите первое отсутствующее событие.
Состояние элемента отделяет логику от декорации
| Симптом | Что измерить | Вероятная причина |
|---|---|---|
| Кнопка ничего не делает | click и ссылка на dialog | Handler не привязан или найден другой экземпляр |
| Escape не закрывает | cancel.defaultPrevented | Обработчик отменил close request |
| Окно исчезло, фон остался | open и класс на body | Cleanup разделён между функциями |
| Закрывается только первый раз | Количество listeners после открытия | Обработчики добавляются повторно |
| Клик внутри закрывает окно | event.target и currentTarget | Backdrop не отличён от содержимого |
Одна функция завершает весь цикл
const dialog = document.querySelector("#cart-dialog");
const opener = document.querySelector("#open-cart");
function finishDialog(value = "") {
if (dialog.open) dialog.close(value);
}
dialog.addEventListener("close", () => {
document.body.classList.remove("scroll-locked");
if (opener.isConnected) opener.focus();
});Кнопка закрытия вызывает finishDialog, а очистка выполняется на событии close независимо от источника: кнопка, форма method="dialog" или разрешённый Escape. Повторный вызов не пытается закрыть уже закрытый элемент. Если состояние управляется фреймворком, один источник истины должен запускать эквивалентный cleanup.
Escape сначала создаёт cancel
По стандарту close request для dialog сначала вызывает cancel. Этот event можно отменить через preventDefault; тогда окно закономерно останется открытым. Найдите такой обработчик и оставляйте блокировку только при реальной причине — например, пока идёт необратимая операция. Пользователю рядом нужен понятный путь безопасно выйти.
Метод close() закрывает напрямую и не даёт отменить операцию, а requestClose() проходит через cancel. Эти механизмы не взаимозаменяемы, если приложение должно спросить о несохранённых изменениях.
Backdrop проверяется по точной цели клика
Если light dismiss реализован вручную, закрывайте только когда event.target === dialog или отдельному backdrop, а не любому потомку. Координатный тест по прямоугольнику нужен лишь для дизайна, где сам dialog занимает всю область; его следует проверить на масштабировании и мобильной клавиатуре.
Повторное открытие не добавляет новые listeners
- Постоянные обработчики навешиваются один раз при создании компонента.
- Одноразовый listener получает option once и создаётся только для конкретного цикла.
- Перед размонтированием AbortController отключает связанные обработчики.
- Timeout и незавершённые запросы не меняют уже закрытый экземпляр.
- ID модального окна уникален, а querySelector не выбирает скрытую копию шаблона.
Типичный признак размножения — одно нажатие запускает два запроса или быстро открывает окно снова после закрытия. Счётчик вызовов и breakpoint на addEventListener находят проблему быстрее, чем увеличение z-index.
Закрытие проверяется клавиатурой и повтором
- Открыть dialog и подтвердить open=true и фокус внутри.
- Закрыть кнопкой и проверить open=false, снятый scroll lock и возвращённый фокус.
- Повторить через Escape и увидеть cancel, затем close.
- Отменить cancel в тесте и убедиться, что окно осознанно остаётся открытым.
- Нажать внутри содержимого и не закрыть окно; нажать на backdrop и закрыть.
- Выполнить десять циклов открытия без роста числа обработчиков.
Для диагностики пригодятся HTML элемента, функция открытия, все пути закрытия и журнал четырёх событий без данных формы. Снимок экрана показывает симптом, но окончательную причину дают open, target и defaultPrevented.