CKTIS / JavaScript
MouseEvent.clientY — coordinata verticale dell’area visibile
MouseEvent.clientY è una proprietà di sola lettura che fornisce la coordinata verticale di un evento del mouse rispetto all’area visibile. Non descrive una posizione rispetto all’elemento di destinazione né allo schermo fisico.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.clientYMouseEvent.clientY fornisce la coordinata verticale del punto in cui si è verificato un evento, rispetto all’area visibile associata a quell’evento. Puoi leggerla come event.clientY, ad esempio quando gestisci mousemove o click. È una proprietà di sola lettura.
Il sistema di riferimento è l’area visibile, non l’elemento destinatario dell’evento. Non confonderla con clientX, che descrive la posizione orizzontale, né con screenY, il cui sistema di riferimento è lo schermo. Quando interpreti le coordinate, verifica sempre il relativo sistema di riferimento.
L’esempio crea un evento sintetico con clientY: 120 e un altro senza una coordinata esplicita. Il costruttore inizializza la proprietà; non le assegni un valore dopo aver creato l’oggetto. Se clientY viene omessa, il valore predefinito è 0. La creazione dell’evento non sposta il puntatore reale del mouse.
Esegui l’esempio nella console del browser. I risultati attesi sono 120 e poi 0. Questa è un’API Web, non una funzionalità di ECMAScript in sé; la presenza di Node 24 in un repository non dimostra che MouseEvent sia disponibile in quell’ambiente.
Esempi
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Risultato
120 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.