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.