Модальное окно без единой строчки JavaScript: как работают HTML-атрибуты commandfor и command для dialogЗаметка · дайджест за 22 ноября
Инфографический патентный чертеж диалогового окна HTML5 с кнопками управления через атрибуты commandfor и command
Заметка3 раздела≈ 4 мин

Модальное окно без единой строчки JavaScript: как работают HTML-атрибуты commandfor и command для dialog

На первый взгляд кажется, что без скрипта обычное модальное окно на странице не откроешь. Сразу всплывает привычный ритуал: найти кнопку и <dialog> через querySelector, повесить слушатель клика, дёрнуть showModal(), а потом повторить то же самое для закрытия. Так правда было годами. Но в HTML Living Standard появился Invoker Commands API, который переносит всё базовое управление прямо в атрибуты кнопки.

Что изменилось по сравнению с обычным JS

Раньше даже для простого окна подтверждения приходилось писать шаблонную обвязку на JavaScript:

// Старый подход: связываем элементы руками
const openBtn = document.querySelector('#open-btn');
const closeBtn = document.querySelector('#close-btn');
const dialog = document.querySelector('#confirm-dialog');

openBtn.addEventListener('click', () => dialog.showModal());
closeBtn.addEventListener('click', () => dialog.close());

На живом проекте таких окон набирается с десяток. Приходится следить за слушателями и держать связь кнопки с диалогом в отдельном JS-файле. Заглянешь в разметку — и сразу не поймёшь, что делает кнопка.

С Invoker Commands API вся связь переезжает в HTML. Кнопке <button> задают два атрибута: commandfor с id целевого элемента и command с действием. Кнопка работает как пульт от телевизора: commandfor привязывает пульт к экрану, а command говорит, какую клавишу нажать. Скрипт для открытия и закрытия становится не нужен.

Как работают show-modal, close, request-close и кастомные команды

Для <dialog> в стандарт встроены три команды. Первая, show-modal, повторяет метод dialog.showModal(): переносит окно в верхний слой браузера (top layer) и рисует подложку ::backdrop. Верхний слой работает как стеклянная полка поверх документа — чужая шапка с z-index: 9999 окно не перекроет. Если диалог уже открыт, повторный клик ничего не сломает.

За выход отвечают две команды, и разница между ними важна для форм:

  • command="close" захлопывает диалог мгновенно (аналог dialog.close()).
  • command="request-close" вежливо просит закрыть окно (аналог dialog.requestClose()): сначала на диалоге срабатывает событие cancel. Если в форме остался несохранённый черновик, ты можешь перехватить cancel, вызвать event.preventDefault() и остановить закрытие.

Попробуй обе кнопки прямо в песочнице ниже.

Живой пример: модальный dialog на commandfor и command

Браузер сам берёт на себя и доступность: при show-modal фокус прыгает внутрь диалога, клавиша Esc закрывает окно, а после выхода фокус возвращается на кнопку. Скринридеры сразу видят связь без ручных aria-атрибутов.

Те же атрибуты управляют поповерами через toggle-popover, show-popover и hide-popover — они пришли на смену более узким popovertarget и popovertargetaction. А для своей логики можно придумать команду с префиксом --, например command="--copy-code": при клике на целевом элементе выстрелит событие command (объект CommandEvent), которое легко поймать в JS.

Поддержка браузеров и где всё равно нужен скрипт

Invoker Commands API уже получил статус Baseline Newly Available. Это значит, что фича работает во всех современных движках — Chrome, Edge, Firefox и Safari, но ещё не набрала 30 месяцев стажа для Widely Available. На старых iOS и редких корпоративных браузерах атрибуты могут не сработать.

Страхуется это проверкой из песочницы выше: 'commandForElement' in HTMLButtonElement.prototype. Если свойства нет, включаем фолбэк с showModal() и close(). В свежих браузерах этот код не запустится.

Есть и пара честных границ. Атрибут commandfor работает только на <button> — на <a> или <div> он не сработает. И скрипт всё равно нужен, если перед открытием надо подгрузить данные, проверить черновик в cancel или обработать команду --*. Зато для обычных подтверждений лишний JS исчезает целиком.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3