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 Werten für commandForElement und command gesteuert wird, sobald mit dem Button interagiert wird (z. B. durch einen Klick).
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("command", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
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");
}
});
Auslösen und Abbrechen von Ereignissen
Beachten Sie, dass command-Ereignisse auf dem aufgerufenen Element ausgelöst werden. Wenn der Button angeklickt wird, löst er zunächst ein click-Ereignis aus. Wird dieses abgebrochen, wird das command-Ereignis nicht ausgelöst und das Standardverhalten nicht ausgeführt.
Neben dem click-Ereignis auf dem Button kann auch das command-Ereignis abgebrochen werden.
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 |