[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/HTMLButtonElement/command [Back]  [Original]

HTMLButtonElement: command-Eigenschaft - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen bersetzt, und kann Fehler enthalten. Erfahre mehr ber dieses Experiment.

View in English Always switch to English

HTMLButtonElement: command-Eigenschaft

Baseline 2025
Neu verfgbar

Seit Dezember 2025 funktioniert diese Funktion auf aktuellen Gerten und in aktuellen Browserversionen. Auf lteren Gerten oder in lteren Browsern funktioniert sie mglicherweise nicht.

Die command-Eigenschaft der HTMLButtonElement-Schnittstelle ruft die Aktion ab und legt sie fest, die bei einem durch diese Schaltflche gesteuerten Element ausgefhrt werden soll. Damit dies Wirkung zeigt, muss commandfor gesetzt sein.

Sie spiegelt das command-HTML-Attribut wider.

In diesem Artikel

Wert

Ein String. Siehe das command Attribut fr gltige Werte.

Beispiele

Einfaches Beispiel

html
<button id="toggleBtn" commandfor="mypopover" command="toggle-popover">
  Toggle popover
</button>

<div popover id="mypopover">
  <button commandfor="mypopover" command="hide-popover">Hide popover</button>
</div>
js
const popover = document.getElementById("mypopover");
const toggleBtn = document.getElementById("toggleBtn");

toggleBtn.command = "show-popover";

Verwendung benutzerdefinierter Werte fr Befehle

In diesem Beispiel wurden drei Schaltflchen mit benutzerdefinierten Werten fr command erstellt. Jede Schaltflche zielt auf dasselbe Bild unter Verwendung des commandfor-Attributs ab.

html
<div class="controls">
  <button commandfor="the-image" command="--rotate-left">Rotate Left</button>
  <button commandfor="the-image" command="--reset">Reset</button>
  <button commandfor="the-image" command="--rotate-right">Rotate Right</button>
</div>

<img
  id="the-image"
  src="/shared-assets/images/examples/dino.svg"
  alt="dinosaur head rotated 0 degrees" />

Ein Event-Listener wird dem Bild mit dem command event zugeordnet. Wenn eine der Schaltflchen angeklickt wird, fhrt der Listener Code basierend auf dem benutzerdefinierten command-Wert aus, der der Schaltflche zugewiesen ist, dreht das Bild und aktualisiert auch den alt-Text, um den neuen Winkel des Bildes anzuzeigen.

js
const image = document.getElementById("the-image");

image.addEventListener("command", (event) => {
  let rotate = parseInt(event.target.style.rotate || "0", 10);
  if (event.command === "--reset") {
    rotate = 0;
    event.target.style.rotate = `${rotate}deg`;
  } else if (event.command === "--rotate-left") {
    rotate = rotate === -270 ? 0 : rotate - 90;
    event.target.style.rotate = `${rotate}deg`;
  } else if (event.command === "--rotate-right") {
    rotate = rotate === 270 ? 0 : rotate + 90;
    event.target.style.rotate = `${rotate}deg`;
  }
  event.target.alt = `dinosaur head rotated ${rotate} degrees`;
});

Spezifikationen

Spezifikation
HTML
# dom-button-command

Browser-Kompatibilitt

Siehe auch


Web Proxy Viewer  |  New URL  |  Original Page