CommandEvent
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die CommandEvent-Schnittstelle repräsentiert ein Ereignis, das den Benutzer benachrichtigt, wenn ein button-Element mit gültigen commandForElement- und command-Attributen ein interaktives Element aufzurufen beabsichtigt.
Dies ist das Ereignisobjekt für das HTMLElement-command-Ereignis, das eine Aktion von einem Invoker Control darstellt, wenn es aufgerufen wird (zum Beispiel, wenn es angeklickt oder gedrückt wird).
Konstruktor
CommandEvent()-
Erstellt ein
CommandEvent-Objekt.
Instanz-Eigenschaften
Diese Schnittstelle erbt Eigenschaften von ihrem Elternteil, Event.
CommandEvent.sourceSchreibgeschützt-
Ein
HTMLButtonElement, das den Button repräsentiert, der diese Auslösung verursacht hat. CommandEvent.commandSchreibgeschützt-
Ein String, der den
command-Wert des auslösenden Buttons darstellt.
Beispiele
Einfaches Beispiel
<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>
const popover = document.getElementById("mypopover");
// …
popover.addEventListener("command", (event) => {
if (event.command === "show-popover") {
console.log("Popover is about to be shown");
}
});
Benutzerdefiniertes Beispiel
<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]" />
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
Loading…