Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

command: assegnare un’azione dichiarativa a un pulsante

Invoca azioni native di dialoghi e popover oppure invia un comando personalizzato.

Versione: HTML Living Standard

Sintassi

<button type="button" command="show-modal" commandfor="details">Open</button>

L’attributo command assegna al pulsante un’azione per l’elemento identificato come destinazione del comando. Fra i valori incorporati ci sono show-modal, close e request-close per i dialoghi, oltre alle azioni per mostrare, nascondere e alternare i popover. L’azione deve essere valida per la destinazione. Valori assenti o sconosciuti non diventano JavaScript arbitrario e non eseguono testo sorgente.

I nomi dei comandi personalizzati iniziano con -- e inviano un evento che il codice applicativo deve gestire; non inventano un’operazione nativa. Annullare l’evento di comando impedisce l’azione predefinita. Usa type="button" quando il controllo non deve inviare o ripristinare un modulo. Un pulsante disabilitato non invoca l’azione e questo supporto recente richiede controlli di capacità.

L’esempio usa due pulsanti nativi per mostrare un dialogo modale e chiuderlo. Chromium 145 esegue entrambe le azioni senza gestori applicativi nel ramo supportato. Un ripiego separato installa gestori espliciti quando manca la capacità DOM. Il risultato provato riguarda questo browser, non ogni WebView incorporata o motore precedente.

Esempi

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

Risultato

opened=true; closed=true

Nel ramo verificato il dialogo è aperto e chiuso da comandi nativi; i gestori di ripiego non vengono installati.

Fonti