WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.clientY

MouseEvent.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.

Quellen