CKTIS / JavaScript
MouseEvent.clientY — pionowa współrzędna względem obszaru widoku
MouseEvent.clientY to właściwość tylko do odczytu, która podaje pionową współrzędną zdarzenia myszy względem obszaru widoku. Nie określa pozycji względem elementu ani fizycznego ekranu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.clientYMouseEvent.clientY podaje pionową współrzędną miejsca wystąpienia zdarzenia względem obszaru widoku powiązanego ze zdarzeniem. Odczytujesz ją jako event.clientY, na przykład podczas obsługi mousemove lub click. Jest to właściwość tylko do odczytu.
Punktem odniesienia jest obszar widoku, a nie element będący celem zdarzenia. Nie myl jej z clientX, które opisuje położenie poziome, ani z screenY, którego układem odniesienia jest ekran. Przy interpretacji współrzędnych zawsze sprawdzaj ich układ odniesienia.
Przykład tworzy syntetyczne zdarzenie z clientY: 120 oraz drugie bez podanej współrzędnej. Konstruktor inicjalizuje właściwość; nie przypisujesz jej wartości po utworzeniu obiektu. Pominięte clientY ma wartość domyślną 0. Utworzenie zdarzenia nie przesuwa rzeczywistego wskaźnika myszy.
Uruchom przykład w konsoli przeglądarki. Oczekiwane wyniki to kolejno 120 i 0. Jest to interfejs Web API, a nie funkcja samego ECMAScript; obecność Node 24 w repozytorium nie dowodzi dostępności MouseEvent w tym środowisku.
Przykłady
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Wynik
120 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.