CKTIS / HTML
command: dar a un botón una acción declarativa
Invoca acciones nativas de diálogo o popover, o despacha una orden personalizada.
Versión: HTML Living Standard
Sintaxis
<button type="button" command="show-modal" commandfor="details">Open</button>El atributo command da al botón una acción para el elemento identificado como destino de su orden. Los valores incorporados incluyen show-modal, close y request-close para diálogos, además de acciones de mostrar, ocultar y alternar popovers. La acción debe ser válida para el destino. Los valores ausentes o desconocidos no se convierten en JavaScript arbitrario ni ejecutan texto fuente.
Los nombres de órdenes personalizadas empiezan por -- y despachan un evento que debe gestionar la aplicación; no inventan una operación nativa. Cancelar el evento de orden impide su acción predeterminada. Usa type="button" cuando el control no deba enviar ni restablecer un formulario. Un botón deshabilitado no invoca la acción, y esta compatibilidad reciente requiere comprobar las capacidades.
El ejemplo utiliza dos botones nativos para mostrar un diálogo modal y cerrarlo. Chromium 145 ejecuta ambas acciones sin manejadores de aplicación en la rama compatible. Una alternativa separada instala manejadores explícitos si falta la capacidad DOM. El resultado probado cubre este navegador, no todas las WebView integradas ni los motores antiguos.
Ejemplos
<!doctype html><meta charset="utf-8">
<button id="open" type="button" command="show-modal" commandfor="details">Open</button>
<dialog id="details"><p>Details</p><button id="close" type="button" command="close" commandfor="details">Close</button></dialog>
<output id="result"></output><script>
const open = document.querySelector('#open'), details = document.querySelector('#details');
if ('command' in open && 'commandForElement' in open) {
open.click(); const opened = details.open && details.matches(':modal');
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'opened=' + opened + '; closed=' + !details.open;
} else {
open.onclick = () => details.showModal();
document.querySelector('#close').onclick = () => details.close();
document.querySelector('#result').textContent = 'command unsupported; explicit handlers installed';
}
</script>Resultado
opened=true; closed=true
En la rama verificada, órdenes nativas abren y cierran el diálogo; no se instalan los manejadores alternativos.