HTMLElement: command-Ereignis
Baseline
2025
Neu verfügbar
Seit December 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Das command-Ereignis der HTMLElement-Schnittstelle wird auf einem Element ausgelöst, das über einen button mit gültigen commandForElement- und command-Werten gesteuert wird, wann immer der Button interagiert wird (z. B. wenn er angeklickt wird).
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("command", (event) => { })
oncommand = (event) => { }
Ereignistyp
Ein CommandEvent. Erbt von Event.
Beispiele
Einfaches Beispiel
const popover = document.getElementById("mypopover");
// …
popover.addEventListener("command", (event) => {
if (event.command === "show-popover") {
console.log("Popover is about to be shown");
}
});
Ereignisaufruf und Abbruch
Es ist erwähnenswert, dass command-Ereignisse auf dem Element ausgelöst werden, das aufgerufen wird. Wenn der Button angeklickt wird, löst er zunächst ein click-Ereignis aus, welches, falls es abgebrochen wird, das command-Ereignis nicht auslösen und das Standardverhalten nicht ausgeführt wird. Zusätzlich zum Abbrechen des click-Ereignisses auf dem Button ist es auch möglich, das command-Ereignis abzubrechen.
Zum Beispiel:
button.addEventListener("click", (event) => {
event.preventDefault(); // the `command` event will never fire
});
element.addEventListener("command", (event) => {
event.preventDefault(); // the `command` event fires but the default behavior is cancelled
});
Spezifikationen
| Spezifikation |
|---|
| HTML # event-command |