Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

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

Fonti