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.clientYMouseEvent.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.