WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

MouseEvent: Schaltfläche, Koordinaten und Zusatztasten

MouseEvent-Felder geben die zu einem Ereignis gehörende Schaltfläche, die auf den Viewport bezogenen Zeigerkoordinaten und den Status von Ctrl, Meta, Shift und Alt an. Unterscheide button von buttons sowie Viewport-Koordinaten von Dokumentkoordinaten.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent ist eine Web-API-Schnittstelle des Browsers und kein Bestandteil von ECMAScript selbst. Ihre Instanzeigenschaften sind schreibgeschützt. Lies sie in einem Ereignishandler aus dem empfangenen Objekt aus, etwa mit event.clientX; MouseEvent.clientX ist eine Schreibweise aus der Dokumentation und kein Zugriff auf eine statische Eigenschaft.

MouseEvent.button gibt an, welche Schaltfläche gedrückt oder losgelassen wurde: 0 — primäre, 1 — mittlere, 2 — sekundäre, 3 — normalerweise Zurück, 4 — normalerweise Vorwärts. Die primäre Schaltfläche muss nicht physisch links liegen, da Nutzer die Konfiguration ändern können. 0 kann auch einen nicht initialisierten Zustand bedeuten. Verwende button nicht, um bei mousemove festzustellen, welche Schaltflächen gehalten werden; dafür dient die Bitmaske buttons.

MouseEvent.clientX und MouseEvent.clientY liefern die horizontale beziehungsweise vertikale Koordinate in Pixeln relativ zum Viewport, nicht zum Element oder zum gesamten Dokument. Die linke und die obere Kante des Viewports entsprechen dem Wert 0, auch wenn das Dokument gescrollt wurde. Gehe nicht davon aus, dass Koordinaten ganzzahlig sein müssen.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey und MouseEvent.altKey sind boolesche Werte, die den Status von Ctrl, Meta, Shift beziehungsweise Alt zum Zeitpunkt des Ereignisses beschreiben. Meta ist unter macOS die Command-Taste und auf Windows-Tastaturen die Windows-Taste. Das Betriebssystem kann Meta abfangen. Unter macOS öffnet Ctrl-Klick ein Kontextmenü, daher ist ctrlKey bei diesem click-Ereignis nicht erkennbar.

Diese Felder und der Konstruktor werden von Browsern weitgehend unterstützt; dass Node 24 in einem Repository vorhanden ist, belegt keine Unterstützung der Browser-API. Das Beispiel erstellt ein synthetisches mousedown mit festgelegten Daten: Es bewegt weder den Zeiger noch löst es das Ereignis an einem Element aus.

Beispiele

const event = new MouseEvent("mousedown", {
  button: 0,
  clientX: 120,
  clientY: 80,
  ctrlKey: true,
  metaKey: false,
  shiftKey: true,
  altKey: false
});

console.log(JSON.stringify({
  button: event.button,
  x: event.clientX,
  y: event.clientY,
  ctrl: event.ctrlKey,
  meta: event.metaKey,
  shift: event.shiftKey,
  alt: event.altKey
}));

Ergebnis

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen