CommandEvent

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.

Die CommandEvent-Schnittstelle stellt ein Ereignis dar, das den Benutzer benachrichtigt, wenn ein button-Element mit gültigen Attributen commandForElement und command ein interaktives Element auslösen soll.

Dies ist das Ereignisobjekt für das HTMLElement-command-Ereignis, das eine Aktion eines "Invoker Control" repräsentiert, wenn es ausgelöst wird (zum Beispiel durch Klick oder Drücken).

Event CommandEvent

Konstruktor

CommandEvent()

Erstellt ein CommandEvent-Objekt.

Instanzeigenschaften

Diese Schnittstelle erbt Eigenschaften von ihrem Elternobjekt Event.

CommandEvent.source Schreibgeschützt

Ein HTMLButtonElement, das den Button repräsentiert, der diese Ausführung ausgelöst hat.

CommandEvent.command Schreibgeschützt

Ein String, der den command-Wert des verursachenden Buttons darstellt.

Beispiele

Einfaches Beispiel

html
<button commandfor="mypopover" command="show-popover">Show popover</button>

<div popover id="mypopover" role="[declare appropriate ARIA role]">
  <!-- popover content here -->
  <button commandfor="mypopover" command="hide-popover">Hide popover</button>
</div>
js
const popover = document.getElementById("mypopover");

// ...

popover.addEventListener("command", (event) => {
  if (event.command === "show-popover") {
    console.log("Popover is about to be shown");
  }
});

Benutzerdefiniertes Beispiel

html
<button commandfor="the-image" command="--rotate-left">Rotate Left</button>

<button commandfor="the-image" command="--rotate-right">Rotate Right</button>

<img id="the-image" src="photo.jpg" alt="[add appropriate alt text here]" />
js
const image = document.getElementById("the-image");

image.addEventListener("command", (event) => {
  if (event.command == "--rotate-left") {
    event.target.style.rotate = "-90deg";
  } else if (event.command == "--rotate-right") {
    event.target.style.rotate = "90deg";
  }
});

Spezifikationen

Specification
HTML
# commandevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch