WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

MouseEvent: Maustastencode und Viewport-Koordinaten

Mit `button` erkennst du, welche Maustaste gedrückt oder losgelassen wurde. Mit `clientX` und `clientY` liest du die Position des Ereignisses im Viewport aus.

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

Syntax

event.button
 event.clientX
 event.clientY

new MouseEvent(type, { button, buttons, clientX, clientY })

button, clientX und clientY sind schreibgeschützte Instanzeigenschaften von MouseEvent. In einer Ereignisbehandlung liest du event.button, nicht MouseEvent.button. MouseEvent ist eine Web-API und kein Bestandteil von ECMAScript 2024. Fehlt der Konstruktor und ist der Name nicht definiert, wirft new MouseEvent(...) einen ReferenceError.

Bei Ereignissen wie mousedown und mouseup gibt button an, welche Taste gedrückt oder losgelassen wurde: 0 primär (meist links), 1 Hilfstaste (meist Mitte), 2 sekundär (meist rechts), 3 vierte Taste (meist Zurück), 4 fünfte Taste (meist Vorwärts). Das sind logische Rollen, keine festen physischen Positionen. Bei mousemove beweist button === 0 nicht, dass die Primärtaste gehalten wird. Dafür gibt es die Bitmaske buttons: 0 steht für keine gehaltene Taste, und (event.buttons & 1) !== 0 prüft die Primärtaste.

clientX und clientY sind die horizontale bzw. vertikale Koordinate des Ereignisses in CSS-Pixeln. Links oben im Viewport liegt (0, 0); X wächst nach rechts, Y nach unten. Beim Scrollen bleibt der Ursprung gleich, aber derselbe Dokumentpunkt kann bei einem späteren Ereignis andere Client-Koordinaten haben. pageX und pageY beziehen sich auf das Dokument, screenX und screenY auf den Bildschirm. Client-Koordinaten sind nicht relativ zum Zielelement.

Mit new MouseEvent(type, options) legst du die Anfangswerte eines synthetischen Ereignisses fest. Beim Erzeugen des Objekts wird das Ereignis nicht ausgelöst und der Zeiger nicht bewegt. Das Ereignis hat isTrusted === false und bewirkt keine Nutzeraktivierung.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>MouseEvent example</title>
<pre id="output"></pre>
<script>
  {
    const event = new MouseEvent("mouseup", {
      button: 2,
      buttons: 0,
      clientX: 120,
      clientY: 45,
    });

    document.getElementById("output").textContent =
      `button=${event.button}, buttons=${event.buttons}, clientX=${event.clientX}, clientY=${event.clientY}`;
  }
</script>

Ergebnis

button=2, buttons=0, clientX=120, clientY=45

Speichere das Beispiel als HTML-Datei und öffne sie im Browser. Das synthetische `mouseup` beschreibt das Loslassen der Sekundärtaste bei `(120, 45)`; `buttons=0` bedeutet, dass keine Taste mehr gehalten wird. Du musst nicht klicken.

Zugehörige Lektionen

  • JavaScript · Lektion 35 · Mittlere Stufe · Version: 3

Quellen