HTMLElement: command-Ereignis

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.

js
addEventListener("command", (event) => {});

oncommand = (event) => {};

Ereignistyp

Ein CommandEvent. Erbt von Event.

Beispiele

Einfaches Beispiel

js
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:

js
button.addEventListener("click", (event) => {
  event.preventDefault(); // the `command` event will never fire
});
js
element.addEventListener("command", (event) => {
  event.preventDefault(); // the `command` event fires but the default behavior is cancelled
});

Spezifikationen

No specification found

No specification data found for api.HTMLElement.command_event.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch