MouseEvent: movementY-Eigenschaft
Baseline 2026
Neu verfügbar
Seit Januar 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die schreibgeschützte movementY-Eigenschaft des MouseEvent-Interfaces liefert den Unterschied in der Y-Koordinate der Maus (oder des Zeigers) zwischen dem angegebenen Bewegungsereignis und dem vorherigen Bewegungsereignis desselben Typs.
Mit anderen Worten, der Wert der Eigenschaft wird wie folgt berechnet: currentEvent.movementY = currentEvent.screenY - previousEvent.screenY.
Der Wert ist für alle Ereignisse außer mousemove, pointermove und pointerrawupdate null.
Warnung:
Browser verwenden für movementY und screenY unterschiedliche Einheiten als in der Spezifikation definiert.
Abhängig vom Browser und Betriebssystem können die movementY-Einheiten ein physisches Pixel, ein logisches Pixel oder ein CSS-Pixel sein.
Sie sollten möglicherweise die Bewegungseigenschaften vermeiden und stattdessen das Delta zwischen den aktuellen Client-Werten (screenX, screenY) und den vorherigen Client-Werten berechnen.
Wert
Eine Zahl.
Immer null bei jedem MouseEvent außer mousemove und jedem PointerEvent außer pointermove oder pointerrawupdate.
Beispiele
Mausbewegung für mousemove-Ereignisse protokollieren
Dieses Beispiel protokolliert die Menge der Mausbewegung mithilfe von movementX und movementY.
HTML
<p id="log">Move your mouse around inside this element.</p>
JavaScript
const log = document.getElementById("log");
function logMovement(event) {
log.innerText = `movement: ${event.movementX}, ${event.movementY}\n${log.innerText}`;
}
document.addEventListener("mousemove", logMovement);
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| Pointer Lock 2.0 # dom-mouseevent-movementy |