CKTIS / JavaScript
MouseEvent.clientY — navpična koordinata vidnega polja
MouseEvent.clientY je lastnost samo za branje, ki podaja navpično koordinato dogodka miške glede na vidno polje. Ne opisuje položaja glede na ciljni element ali fizični zaslon.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
event.clientYMouseEvent.clientY podaja navpično koordinato mesta, kjer se je zgodil dogodek, glede na vidno polje, povezano s tem dogodkom. Preberete jo lahko kot event.clientY, na primer pri obravnavi dogodkov mousemove ali click. To je lastnost samo za branje.
Referenčni okvir je vidno polje, ne element, na katerega je dogodek usmerjen. Ne zamenjujte je z clientX, ki opisuje vodoravni položaj, ali s screenY, katere referenčni okvir je zaslon. Pri razlagi koordinat vedno preverite njihov referenčni okvir.
Primer ustvari sintetični dogodek z clientY: 120 in še enega brez izrecno podane koordinate. Konstruktor inicializira lastnost; po ustvarjanju objekta ji ne dodelite vrednosti. Če clientY izpustite, je privzeta vrednost 0. Ustvarjanje dogodka ne premakne dejanskega kazalca miške.
Primer zaženite v konzoli brskalnika. Pričakovani rezultati so 120 in nato 0. To je spletni API, ne funkcija samega ECMAScripta; prisotnost Node 24 v repozitoriju ne dokazuje, da je MouseEvent v tem okolju na voljo.
Primeri
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Rezultat
120 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.