CKTIS / HTML
command: dar uma ação declarativa a um botão
Invoca ações nativas de diálogo ou popover, ou emite um comando personalizado.
Versão: HTML Living Standard
Sintaxe
<button type="button" command="show-modal" commandfor="details">Open</button>O atributo command dá ao botão uma ação para o elemento identificado como destino do comando. Os valores incorporados incluem show-modal, close e request-close para diálogos, além de ações para mostrar, ocultar e alternar popovers. A ação tem de ser válida para o destino. Valores ausentes ou desconhecidos não se tornam JavaScript arbitrário nem executam texto de código-fonte.
Os nomes de comandos personalizados começam por -- e emitem um evento que o código da aplicação tem de tratar; não inventam uma operação nativa. Cancelar o evento de comando impede a ação predefinida. Usa type="button" quando o controlo não deva enviar nem repor um formulário. Um botão desativado não invoca a ação, e este suporte recente exige verificações de capacidade.
O exemplo usa dois botões nativos para mostrar um diálogo modal e fechá-lo. Chromium 145 executa ambas as ações sem gestores da aplicação no ramo suportado. Uma alternativa separada instala gestores explícitos quando falta a capacidade DOM. O resultado testado abrange este navegador, não todas as WebView incorporadas ou motores mais antigos.
Exemplos
<!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
No ramo verificado, comandos nativos abrem e fecham o diálogo; os gestores alternativos não são instalados.