HTMLElement: `command`-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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, wann immer mit dem Button interagiert wird (z.B. wenn er geklickt 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.action === "show-popover") {
    console.log("Popover is about to be shown");
  }
});

Ereignisauslösung und Abbruch

Es ist erwähnenswert, dass command-Ereignisse auf dem ausgelösten Element feuern. Wenn der Button angeklickt wird, wird zuerst ein click-Ereignis ausgelöst, das, falls es abgebrochen wird, das command-Ereignis nicht feuern lässt 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