WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen