CKTIS / JavaScript
MouseEvent.clientY — svislá souřadnice výřezu zobrazení
MouseEvent.clientY je vlastnost pouze pro čtení, která udává svislou souřadnici události myši vzhledem k výřezu zobrazení. Nepopisuje polohu vzhledem k cílovému prvku ani k fyzické obrazovce.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.clientYMouseEvent.clientY udává svislou souřadnici místa, kde k události došlo, vzhledem k výřezu zobrazení spojenému s danou událostí. Můžete ji číst jako event.clientY, například při zpracování událostí mousemove nebo click. Jde o vlastnost pouze pro čtení.
Referenčním rámcem je výřez zobrazení, nikoli prvek, na který událost cílí. Nezaměňujte ji s clientX, která popisuje vodorovnou polohu, ani s screenY, jejímž referenčním rámcem je obrazovka. Při interpretaci souřadnic vždy ověřte jejich referenční rámec.
Příklad vytvoří syntetickou událost s clientY: 120 a další bez výslovně zadané souřadnice. Konstruktor vlastnost inicializuje; po vytvoření objektu jí hodnotu nepřiřazujete. Pokud clientY vynecháte, výchozí hodnota je 0. Vytvoření události nepohne skutečným ukazatelem myši.
Spusťte příklad v konzoli prohlížeče. Očekávané výsledky jsou postupně 120 a 0. Jde o Web API, nikoli o funkci samotného ECMAScriptu; přítomnost Node 24 v repozitáři nedokazuje, že je MouseEvent v daném prostředí dostupný.
Příklady
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Výsledek
120 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.