CKTIS / HTML
oncommand — tratar o evento command
O atributo oncommand especifica o JavaScript a executar quando é recebido um evento command. Deve ser colocado no elemento que recebe o comando; não seleciona o destino nem inicia um comando por si só.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
oncommand="JavaScript statements"oncommand é um atributo de conteúdo global de tratamento de eventos para o evento command, disponível nos elementos HTML. O seu valor é o corpo de uma função JavaScript, não o nome de um comando. À sua contraparte no DOM, element.oncommand, pode ser atribuída uma função.
No mecanismo de comandos, um botão utiliza commandfor para identificar o elemento de destino e command para especificar a ação. Coloque o processador oncommand no destino, não necessariamente no botão. Os nomes de comandos personalizados começam por --; o seu comportamento é implementado pelo código do autor.
No processador, event.command contém o comando e event.source identifica o elemento que iniciou a ação, tendo em conta as regras de redirecionamento do Shadow DOM. this refere-se ao elemento que trata o evento. No exemplo, o botão envia --report e o parágrafo substitui o seu texto por esse valor.
O exemplo requer que o navegador suporte as funcionalidades relevantes e que a execução de scripts inline seja permitida. Uma Content Security Policy pode bloquear o atributo do processador; em alternativa, uma aplicação pode registar um processador com addEventListener('command', handler) num script permitido.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncommand example</title>
<button type="button" commandfor="target" command="--report">Run</button>
<p id="target" oncommand="if (event.command === '--report') this.textContent = event.command;">Ready</p>
</html>Resultado
--report
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.