CKTIS / HTML
command: einem Button eine deklarative Aktion geben
Rufe native Dialog- oder Popover-Aktionen auf oder versende einen eigenen Befehl.
Version: HTML Living Standard
Syntax
<button type="button" command="show-modal" commandfor="details">Open</button>Das Attribut command weist einem Button eine Aktion für das über sein Befehlsziel bestimmte Element zu. Eingebaute Werte sind unter anderem show-modal, close und request-close für Dialoge sowie Aktionen zum Anzeigen, Verbergen und Umschalten von Popovers. Die Aktion muss zum Ziel passen. Fehlende oder unbekannte Werte werden nicht zu beliebigem JavaScript und führen keinen Quelltext aus.
Eigene Befehlsnamen beginnen mit -- und versenden ein Ereignis, das Anwendungscode behandeln muss; sie erfinden keine native Operation. Ein abgebrochenes Befehlsereignis verhindert die Standardaktion. Verwende type="button", wenn das Bedienelement kein Formular absenden oder zurücksetzen soll. Ein deaktivierter Button ruft die Aktion nicht auf, und die neuere Befehlsunterstützung verlangt Fähigkeitsprüfungen.
Das Beispiel verwendet zwei native Buttons, um einen modalen Dialog anzuzeigen und zu schließen. Chromium 145 führt im unterstützten Zweig beide Aktionen ohne Anwendungshandler aus. Ein getrennter Ersatzpfad installiert ausdrückliche Handler, wenn die DOM-Fähigkeit fehlt. Das Testergebnis gilt für diesen Browser, nicht für jede eingebettete WebView oder ältere Engine.
Beispiele
<!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>Ergebnis
opened=true; closed=true
Im geprüften Zweig öffnen und schließen native Befehle den Dialog; die Ersatzhandler werden nicht installiert.