CKTIS / HTML
closedby: decidir cómo puede cerrarse un diálogo
Separa el cierre automático de los controles explícitos de la aplicación.
Versión: HTML Living Standard
Sintaxis
<dialog closedby="none">...</dialog>En un diálogo, closedby elige las acciones de cierre automático permitidas. any incluye clics fuera y solicitudes de cierre; closerequest incluye solicitudes como Escape, pero no el cierre por clic fuera; none desactiva el cierre automático por acciones del usuario. Los valores ausentes o inválidos usan el estado automático: un diálogo modal permite solicitudes de cierre, mientras que uno no modal no se cierra automáticamente.
Esto no desactiva las acciones deliberadas de la aplicación. Tanto close() como requestClose() siguen disponibles; la segunda genera el evento de cancelación cancelable e ignora la restricción closedby. Proporciona siempre una salida explícita accesible cuando desactives el cierre automático. No elimines manualmente el atributo open para sustituir los métodos de cierre adecuados.
La prueba abre un diálogo modal, pulsa Escape mientras el cierre está desactivado, cambia el ajuste y vuelve a pulsar Escape. Chromium 145 mantuvo abierto el diálogo en el primer intento y lo cerró con la segunda solicitud. El ejemplo comprueba la capacidad DOM y conserva un botón de cierre explícito; no debe suponerse que este atributo reciente funciona en todos los navegadores.
Ejemplos
<!doctype html><meta charset="utf-8">
<dialog id="dialog" closedby="none"><p>Press Escape twice.</p><button id="exit" type="button">Close explicitly</button></dialog>
<output id="result"></output><script>
const dialog = document.querySelector('#dialog');
document.querySelector('#exit').onclick = () => dialog.close();
if (!('closedBy' in dialog)) {
document.querySelector('#result').textContent = 'closedby unsupported; explicit close remains available';
} else {
let count = 0, firstOpen;
document.addEventListener('keydown', event => {
if (event.key !== 'Escape') return;
count += 1;
if (count === 1) setTimeout(() => { firstOpen = dialog.open; dialog.closedBy = 'closerequest'; }, 0);
});
dialog.addEventListener('close', () => {
document.querySelector('#result').textContent = 'none-open=' + firstOpen + '; closerequest-open=' + dialog.open;
});
}
dialog.showModal();
</script>Resultado
none-open=true; closerequest-open=false
La prueba envía dos eventos de teclado reales a la página aislada y comprueba el estado abierto después de cada uno.