Die schreibgeschützte EigenschaftMouseEvent.buttons zeigt an, welche Tasten auf der Maus (oder einem anderen Eingabegerät) gedrückt sind, wenn ein Mausereignis ausgelöst wird.

Jede Taste, die gedrückt werden kann, wird durch eine bestimmte Zahl repräsentiert (siehe unten).Wenn mehr als eine Taste gedrückt wird, werden die Werte der Tasten addiert, um eine neue Zahl zu erzeugen.Wenn beispielsweise die sekundäre (2) und die zusätzliche (4) Taste gleichzeitig gedrückt werden, ist der Wert6 (d.h.2 + 4).

Wert

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

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

Beispiele

Dieses Beispiel protokolliert diebuttons-Eigenschaft, wenn Sie einmousedown-Ereignis auslösen.

HTML

<p>Click anywhere with one or more mouse buttons.</p><pre>[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);

Resultat

Spezifikationen

Browser-Kompatibilität

Firefox Anmerkungen

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

• Dienstprogramme erlauben die Anpassung der Tastenaktionen.Daher muss dieprimäre Taste nicht die linke Taste am Gerät sein, diesekundäre muss nicht die rechte Taste sein, usw.Zudem kann die mittlere (Rad-)Taste, 4. Taste und 5. Taste möglicherweise keinen Wert zugewiesen bekommen, auch wenn sie gedrückt werden.
• Ein-Tasten-Geräte können zusätzliche Tasten mit Kombinationen aus Tasten- und Tastaturdrücken emulieren.
• Touch-Geräte können Tasten mit konfigurierbaren Gesten emulieren (z.B. Ein-Finger-Touch fürprimär, Zwei-Finger-Touch fürsekundär, etc.).
• Auf Linux (GTK) werden die 4. und 5. Taste nicht unterstützt.Außerdem enthält einmouseup-Ereignis immer die Information über die freigegebene Taste imbuttons-Wert.
• Auf Mac OS X 10.5 gibt dasbuttons-Attribut immer0 zurück, da es keine Plattform-API zur Implementierung dieses Features gibt.

Siehe auch

• MouseEvent