Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes