CKTIS / JavaScript
MouseEvent.clientY — vertikale Viewport-Koordinate
MouseEvent.clientY ist eine schreibgeschützte Eigenschaft, die die vertikale Koordinate eines Mausereignisses relativ zum Viewport angibt. Sie beschreibt weder eine Position relativ zum Zielelement noch zum physischen Bildschirm.
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.clientYMouseEvent.clientY gibt die vertikale Koordinate an, an der ein Ereignis aufgetreten ist, bezogen auf den mit diesem Ereignis verknüpften Viewport. Du liest sie beispielsweise bei der Verarbeitung von mousemove oder click als event.clientY aus. Es handelt sich um eine schreibgeschützte Eigenschaft.
Der Bezugspunkt ist der Viewport und nicht das Zielelement des Ereignisses. Verwechsle sie nicht mit clientX, das die horizontale Position beschreibt, oder mit screenY, dessen Bezugssystem der Bildschirm ist. Prüfe beim Interpretieren von Koordinaten immer das jeweilige Bezugssystem.
Das Beispiel erstellt ein synthetisches Ereignis mit clientY: 120 und ein weiteres ohne explizite Koordinate. Der Konstruktor initialisiert die Eigenschaft; du weist ihr nach dem Erstellen des Objekts keinen Wert zu. Wird clientY weggelassen, ist der Standardwert 0. Das Erstellen des Ereignisses bewegt den tatsächlichen Mauszeiger nicht.
Führe das Beispiel in der Browserkonsole aus. Die erwarteten Ergebnisse sind nacheinander 120 und 0. Dies ist eine Web-API und keine Funktion von ECMAScript selbst; dass Node 24 in einem Repository vorhanden ist, belegt nicht, dass MouseEvent in dieser Umgebung verfügbar ist.
Beispiele
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Ergebnis
120 0
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.