MouseEvent: buttons-Eigenschaft

Wert

Eine Zahl, die eine oder mehrere Tasten darstellt. Wenn mehrere Tasten gleichzeitig gedrückt werden, werden die Werte kombiniert (z.B. 3 ist primäre + sekundäre).

• 0: Keine Taste oder nicht initialisiert
• 1: Primäre Taste (normalerweise die linke Taste)
• 2: Sekundäre Taste (normalerweise die rechte Taste)
• 4: Hilfstaste (normalerweise die Mausradtaste oder mittlere Taste)
• 8: 4. Taste (typischerweise die "Browser Zurück"-Taste)
• 16: 5. Taste (typischerweise die "Browser Vor"-Taste)

Beispiele

Dieses Beispiel protokolliert die buttons-Eigenschaft, wenn ein mousedown-Ereignis ausgelöst wird.

HTML

<p>Click anywhere with one or more mouse buttons.</p>
<pre id="log">[No clicks yet]</pre>

JavaScript

const buttonNames = ["left", "right", "wheel", "back", "forward"];
function mouseButtonPressed(event, buttonName) {
  // Use binary `&` with the relevant power of 2 to check if a given button is pressed
  return Boolean(event.buttons & (1 << buttonNames.indexOf(buttonName)));
}

function format(event) {
  const { type, buttons } = event;
  const obj = { type, buttons };
  for (const buttonName of buttonNames) {
    obj[buttonName] = mouseButtonPressed(event, buttonName);
  }
  return JSON.stringify(obj, null, 2);
}

const log = document.getElementById("log");
function logButtons(event) {
  log.textContent = format(event);
}

document.addEventListener("mouseup", logButtons);
document.addEventListener("mousedown", logButtons);

Ergebnis

Spezifikationen

Browser-Kompatibilität

Hinweise zu Firefox

Firefox unterstützt das buttons-Attribut unter Windows, Linux (GTK) und macOS mit den folgenden Einschränkungen:

• Dienstprogramme erlauben die Anpassung der Tastenfunktionen. Daher muss die primäre nicht die linke Taste auf dem Gerät sein, sekundäre nicht die rechte Taste und so weiter. Darüber hinaus müssen die mittlere (Rad-)Taste, 4. Taste und 5. Taste keinen Wert zugewiesen bekommen, selbst wenn sie gedrückt werden.
• Ein-Tasten-Geräte können zusätzliche Tasten mit Kombinationen aus Tasten- und Tastatureingaben emulieren.
• Touch-Geräte können Tasten mit konfigurierbaren Gesten emulieren (z.B. Ein-Finger-Touch für primär, Zwei-Finger-Touch für sekundär usw.).
• Unter Linux (GTK) werden die 4. und 5. Taste nicht unterstützt. Zusätzlich enthält bei einem mouseup-Ereignis der buttons-Wert immer die Information der losgelassenen Taste.
• Unter Mac OS X 10.5 gibt das buttons-Attribut immer 0 zurück, da es keine Plattform-API zur Implementierung dieser Funktion gibt.

Siehe auch

• MouseEvent