HTMLElement: command-Ereignis
Baseline
2025
Newly available
Since December 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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
| Specification |
|---|
| HTML # event-command |