WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

MouseEvent: Maustasten und Modifikatortasten

Lies aus, welche Maustaste ein Ereignis betrifft und ob Strg, Meta, Umschalt oder Alt aktiv war. Unterscheide den Tastencode `button` von der Bitmaske `buttons`.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKey

button, ctrlKey, metaKey, shiftKey und altKey sind schreibgeschützte Instanzeigenschaften von MouseEvent. Lies sie am Ereignisobjekt aus, etwa mit event.button. Sie gehören zur Web-API, nicht zu ECMAScript 2024. Ihre Verfügbarkeit hängt daher von der Laufzeitumgebung ab.

Bei Ereignissen für das Drücken oder Loslassen einer Maustaste, etwa mousedown und mouseup, gibt button den Code einer einzelnen Taste an: 0 primär (meist links), 1 Hilfstaste (meist mittig), 2 sekundär (meist rechts), 3 vierte Taste (typischerweise Zurück), 4 fünfte Taste (typischerweise Vorwärts). Das sind Funktionen, keine festen Positionen. Bei mousemove zeigt button nicht zuverlässig an, ob eine Taste gehalten wird. buttons ist eine Bitmaske der gehaltenen Tasten: 0 bedeutet keine; 1, 2, 4, 8, 16 stehen für die primäre, sekundäre, Hilfs-, vierte und fünfte Taste. (event.buttons & 1) !== 0 prüft das Bit der primären Taste.

ctrlKey steht für Strg, metaKey für Meta (Befehlstaste unter macOS, Windows-Taste unter Windows), shiftKey für Umschalt und altKey für Alt (Wahltaste unter macOS). Jeder Wert ist true, wenn das Ereignis die Taste als gedrückt meldet, sonst false. Das ist der im Ereignis gespeicherte Zustand, keine Live-Abfrage der Tastatur. Das Betriebssystem kann eine Geste abfangen: Unter macOS kann Strg-Klick ein Kontextmenü öffnen, statt ein gewöhnliches click-Ereignis auszulösen. Ein click allein beweist keine Mausbedienung: Er kann auch per Tastatur oder Berührung ausgelöst werden.

Bei new MouseEvent(type, options) haben weggelassene Optionen für button und buttons den Standardwert 0, weggelassene Modifikatoroptionen den Wert false. Ein synthetisches Ereignis hat isTrusted === false und erzeugt nicht die von manchen APIs erforderliche Nutzeraktivierung.

Beispiele

// Use native MouseEvent in browsers. In Node.js, model only the fields read below.
const DemoMouseEvent = globalThis.MouseEvent ?? class extends Event {
  constructor(type, {
    button = 0, buttons = 0,
    ctrlKey = false, metaKey = false, shiftKey = false, altKey = false,
  } = {}) {
    super(type);
    const fields = { button, buttons, ctrlKey, metaKey, shiftKey, altKey };
    for (const [key, value] of Object.entries(fields)) {
      Object.defineProperty(this, key, { value });
    }
  }
};

for (const event of [
  new DemoMouseEvent("mousedown", { button: 1, buttons: 6, ctrlKey: true, shiftKey: true }),
  new DemoMouseEvent("mousemove", { buttons: 2, metaKey: true, altKey: true }),
]) {
  const { type, button, buttons, ctrlKey, metaKey, shiftKey, altKey } = event;
  console.log(JSON.stringify({ type, button, buttons, ctrlKey, metaKey, shiftKey, altKey }));
}

Ergebnis

{"type":"mousedown","button":1,"buttons":6,"ctrlKey":true,"metaKey":false,"shiftKey":true,"altKey":false}
{"type":"mousemove","button":0,"buttons":2,"ctrlKey":false,"metaKey":true,"shiftKey":false,"altKey":true}

Führe den Code in einer Browserkonsole aus. In der ersten Zeile steht `button: 1` für die Hilfstaste; `buttons: 6` kombiniert die Bits der sekundären Taste (`2`) und der Hilfstaste (`4`). In der zweiten Zeile ist `button: 0` der Standardwert, während die Maske nur die sekundäre Taste meldet. Keines der Ereignisse wird ausgelöst.

Zugehörige Lektionen

  • JavaScript · Lektion 37 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 38 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 36 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 37 · Mittlere Stufe · Version: 3

Quellen