HTMLElement: command Ereignis
Baseline 2025
Neu verfügbar
Seit Dezember 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. durch Klicken).
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");
}
});
Ereignisauslösung und Abbruch
Es ist erwähnenswert, dass command-Ereignisse auf dem Element ausgelöst werden, das aufgerufen wird. Wenn der Button angeklickt wird, wird zuerst ein click-Ereignis ausgelöst, das, wenn es abgebrochen wird, das command-Ereignis nicht auslösen wird 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 canceled
});
Spezifikationen
| Spezifikation |
|---|
| HTML # event-command |