CKTIS / JavaScript
MouseEvent.clientY — zvislá súradnica výrezu zobrazenia
MouseEvent.clientY je vlastnosť iba na čítanie, ktorá udáva zvislú súradnicu udalosti myši vzhľadom na výrez zobrazenia. Neopisuje polohu vzhľadom na cieľový prvok ani fyzickú obrazovku.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.clientYMouseEvent.clientY udáva zvislú súradnicu miesta, kde došlo k udalosti, vzhľadom na výrez zobrazenia spojený s touto udalosťou. Môžete ju čítať ako event.clientY, napríklad pri spracovaní udalostí mousemove alebo click. Je to vlastnosť iba na čítanie.
Referenčným rámcom je výrez zobrazenia, nie prvok, na ktorý udalosť smeruje. Nezamieňajte si ju s clientX, ktorá opisuje vodorovnú polohu, ani s screenY, ktorej referenčným rámcom je obrazovka. Pri interpretácii súradníc vždy skontrolujte ich referenčný rámec.
Príklad vytvorí syntetickú udalosť s clientY: 120 a ďalšiu bez výslovne zadanej súradnice. Konštruktor vlastnosť inicializuje; po vytvorení objektu jej hodnotu nepriraďujete. Ak clientY vynecháte, predvolená hodnota je 0. Vytvorenie udalosti nepohne skutočným ukazovateľom myši.
Spustite príklad v konzole prehliadača. Očakávané výsledky sú postupne 120 a 0. Ide o Web API, nie o funkciu samotného ECMAScriptu; prítomnosť Node 24 v repozitári nedokazuje, že je MouseEvent v danom prostredí dostupný.
Príklady
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Výsledok
120 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.