A primera vista parece imposible abrir una ventana modal común sin escribir script. Viene de inmediato el ritual de siempre: buscar el botón y el <dialog> con querySelector, colgar un listener de clic, llamar a showModal() y luego repetir lo mismo para cerrar. Durante años fue así. Pero el HTML Living Standard incorporó la Invoker Commands API, que traslada todo el control básico directo a los atributos del botón.
Qué cambió frente al JavaScript tradicional
Antes, hasta para un simple diálogo de confirmación tocaba escribir código repetitivo en JavaScript:
// Enfoque antiguo: enlazamos elementos a mano
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());
En un proyecto real se acumulan decenas de ventanas así. Hay que vigilar los listeners y mantener el vínculo entre botón y diálogo en un archivo JS aparte. Si miras el HTML, no sabes de inmediato qué hace cada botón.
Con la Invoker Commands API todo el enlace vive en el HTML. Al <button> se le añaden dos atributos: commandfor con el id del elemento destino y command con la acción. El botón funciona como el control remoto de un televisor: commandfor vincula el control a la pantalla y command indica qué tecla pulsar. El script para abrir y cerrar deja de hacer falta.
Cómo operan show-modal, close, request-close y los comandos propios
El estándar incluye tres comandos nativos para <dialog>. El primero, show-modal, equivale a dialog.showModal(): mueve la ventana a la capa superior del navegador (top layer) y dibuja el fondo ::backdrop. Esa capa superior funciona como un estante de vidrio encima del documento, así que un encabezado ajeno con z-index: 9999 nunca la tapará. Si el diálogo ya estaba abierto, otro clic no rompe nada.
Para salir existen dos comandos, y su diferencia importa mucho en formularios:
command="close"cierra el diálogo de golpe (equivalente adialog.close()).command="request-close"pide amablemente cerrar la ventana (equivalente adialog.requestClose()): primero dispara el eventocancelen el diálogo. Si quedó un borrador sin guardar en el formulario, puedes interceptarcancel, llamar aevent.preventDefault()y detener el cierre.
Prueba ambos botones en el ejemplo interactivo de abajo.
Ejemplo vivo: dialog modal con commandfor y command
El navegador también se encarga de la accesibilidad: con show-modal el foco salta dentro del diálogo, la tecla Esc lo cierra y al salir el foco regresa al botón original. Los lectores de pantalla detectan el vínculo al instante sin atributos aria manuales.
Los mismos atributos controlan popovers mediante toggle-popover, show-popover y hide-popover, que reemplazan a los más limitados popovertarget y popovertargetaction. Y para lógica propia puedes inventar un comando con prefijo --, como command="--copy-code": al hacer clic, el elemento destino recibe un evento command (CommandEvent) fácil de escuchar en JS.
Soporte en navegadores y cuándo sigues necesitando script
La Invoker Commands API ya tiene estatus Baseline Newly Available. Esto significa que funciona en todos los motores modernos (Chrome, Edge, Firefox y Safari), aunque todavía no cumple los 30 meses de madurez para Widely Available. En versiones antiguas de iOS o navegadores corporativos viejos los atributos pueden no responder.
Esto se cubre con la comprobación del ejemplo superior: 'commandForElement' in HTMLButtonElement.prototype. Si la propiedad no existe, activas el respaldo con showModal() y close(). En navegadores recientes ese código ni siquiera se ejecuta.
También hay un par de límites claros. El atributo commandfor solo funciona en <button>: en un <a> o un <div> no hará nada. Y seguirás necesitando script si antes de abrir debes cargar datos, validar un borrador en cancel o manejar un comando --*. Pero para confirmaciones normales, el JS extra desaparece por completo.


