CKTIS / HTML
commandfor: dirigir la orden de un botón a su destino
Conecta un botón con un elemento concreto, no con un selector CSS ni con todos los nodos coincidentes.
Versión: HTML Living Standard
Sintaxis
<button type="button" command="--mark" commandfor="first">Mark</button>El atributo commandfor contiene el ID del elemento al que se dirige la orden del botón. El destino debe estar en el mismo árbol. Escribe el ID, no un selector CSS con una almohadilla delante. La propiedad DOM commandForElement expone el elemento asociado cuando la función está admitida. Un destino ausente o no resuelto no puede recibir la orden prevista.
El atributo elige un destinatario; command aporta la operación. Una operación personalizada produce un CommandEvent cuya orden y origen identifican la solicitud y el botón que la invoca. El código de la aplicación debe implementar ese comportamiento personalizado. Usa un tipo de botón explícitamente no enviable y evita ID duplicados, que vuelven poco fiable la asociación pretendida.
La prueba tiene dos destinos posibles, pero envía la solicitud personalizada solo al primero. Su listener marca ese elemento y registra el nombre de la orden y el botón de origen; el segundo listener no se utiliza. Chromium 145 verifica el encaminamiento nativo. Un navegador incompatible informa de la capacidad ausente en vez de fingir que la operación ocurrió.
Ejemplos
<!doctype html><meta charset="utf-8">
<button id="send" type="button" command="--mark" commandfor="first">Mark</button>
<div id="first">First target</div><div id="second">Second target</div><output id="result"></output>
<script>
const send = document.querySelector('#send'); let second = false;
document.querySelector('#second').addEventListener('command', () => { second = true; });
document.querySelector('#first').addEventListener('command', event => {
event.currentTarget.dataset.marked = 'yes';
document.querySelector('#result').textContent = 'target=' + event.currentTarget.id + '; command=' + event.command + '; source=' + event.source.id + '; second=' + second;
});
if ('commandForElement' in send) send.click();
else document.querySelector('#result').textContent = 'commandfor unsupported; install an explicit event-routing fallback';
</script>Resultado
target=first; command=--mark; source=send; second=false
El destino marcado, la cadena de orden, el botón de origen y el segundo destino intacto se comprueban en el navegador real.