Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

commandfor: encaminhar o comando de um botão para o destino

Liga um botão a um elemento específico, não a um seletor CSS nem a todos os nós correspondentes.

Versão: HTML Living Standard

Sintaxe

<button type="button" command="--mark" commandfor="first">Mark</button>

O atributo commandfor contém o ID do elemento destinatário do comando de um botão. O destino tem de estar na mesma árvore. Escreve o próprio ID, não um seletor CSS com cardinal no início. A propriedade DOM commandForElement expõe o elemento associado quando a funcionalidade é suportada. Um destino ausente ou não resolvido não pode receber o comando pretendido.

O atributo escolhe um destinatário; command fornece a operação. Uma operação personalizada produz um CommandEvent cujo comando e origem identificam o pedido e o botão que o invoca. O código da aplicação tem de implementar esse comportamento personalizado. Usa um tipo de botão explicitamente sem envio e evita IDs duplicados, que tornam a associação pretendida pouco fiável.

O ambiente de teste tem dois destinos possíveis, mas envia o pedido personalizado apenas ao primeiro. O seu listener marca esse elemento e regista o nome do comando e o botão de origem; o segundo listener não é usado. Chromium 145 verifica o encaminhamento nativo. Um navegador incompatível comunica a capacidade em falta em vez de fingir que a operação ocorreu.

Exemplos

<!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

O destino marcado, a cadeia de comando, o botão de origem e o segundo destino intacto são verificados no navegador real.

Fontes