Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

MouseEvent.clientY — coordenada vertical da área de visualização

MouseEvent.clientY é uma propriedade só de leitura que indica a coordenada vertical de um evento do rato em relação à área de visualização. Não descreve uma posição em relação ao elemento de destino nem ao ecrã físico.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

event.clientY

MouseEvent.clientY indica a coordenada vertical do local onde ocorreu um evento, em relação à área de visualização associada a esse evento. Pode lê-la como event.clientY, por exemplo, ao tratar mousemove ou click. É uma propriedade só de leitura.

O referencial é a área de visualização, não o elemento de destino do evento. Não a confunda com clientX, que descreve a posição horizontal, nem com screenY, cujo referencial é o ecrã. Verifique sempre o referencial ao interpretar coordenadas.

O exemplo cria um evento sintético com clientY: 120 e outro sem uma coordenada explícita. O construtor inicializa a propriedade; não lhe atribui um valor depois de criar o objeto. Se clientY for omitida, o valor predefinido é 0. A criação do evento não move o ponteiro real do rato.

Execute o exemplo na consola do navegador. Os resultados esperados são 120 e, em seguida, 0. Trata-se de uma API Web, não de uma funcionalidade do próprio ECMAScript; a presença do Node 24 num repositório não comprova que MouseEvent esteja disponível nesse ambiente.

Exemplos

const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");

console.log(event.clientY);
console.log(defaultEvent.clientY);

Resultado

120
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes