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

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.

Fontes