База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

MouseEvent.clientY — вертикална координата спрямо прозореца за визуализация

MouseEvent.clientY е свойство само за четене, което указва вертикалната координата на събитие на мишката спрямо прозореца за визуализация. То не описва позиция спрямо целевия елемент или физическия екран.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.clientY

MouseEvent.clientY указва вертикалната координата на мястото, където е възникнало събитието, спрямо прозореца за визуализация, свързан с него. Можете да я прочетете като event.clientY, например при обработване на mousemove или click. Това е свойство само за четене.

Референтната рамка е прозорецът за визуализация, а не елементът, към който е насочено събитието. Не я бъркайте с clientX, което описва хоризонталната позиция, или със screenY, чиято референтна рамка е екранът. Винаги проверявайте референтната рамка, когато тълкувате координати.

Примерът създава синтетично събитие с clientY: 120 и друго без изрично зададена координата. Конструкторът инициализира свойството; не му присвоявате стойност след създаването на обекта. Ако clientY е пропуснато, стойността по подразбиране е 0. Създаването на събитието не премества действителния показалец на мишката.

Изпълнете примера в конзолата на браузъра. Очакваните резултати са последователно 120 и 0. Това е Web API, а не функция на самия ECMAScript; наличието на Node 24 в хранилище не доказва, че MouseEvent е достъпен в тази среда.

Примери

const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");

console.log(event.clientY);
console.log(defaultEvent.clientY);

Резултат

120
0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници