HTMLElement: command-Ereignis

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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 der Button interagiert wird (z.B. wenn er geklickt wird).

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder legen Sie eine Ereignis-Handler-Eigenschaft fest.

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");
  }
});

Ereignisverteilung und Abbruch

Es ist erwähnenswert, dass command-Ereignisse auf dem Element ausgelöst werden, das aufgerufen wird. Wenn der Button geklickt wird, wird zuerst ein click-Ereignis ausgelöst, das, wenn es abgebrochen wird, dann das command-Ereignis nicht ausgelöst wird und das Standardverhalten nicht ausgeführt wird. Zusätzlich zur Stornierung 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