Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje