Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

MouseEvent.clientY

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

A propriedade clientY da interface MouseEvent fornece a coordenada vertical do cliente dentro da aplicacão em que o evento ocorreu (ao contrário da coordenada que pertence a página).

Por exemplo, clicando no topo da área do cliente sempre resultará num evento de mouse com um valor 0 de clientY, independente se a página está "escrollada" verticalmente.

Sintaxe

var y = instanciaDeEventoDoMouse.clientY

Valor de retorno

O valor retornado por essa propriedade é um valor flutuante double como foi redefinida pelo "CSSOM View Module". Originalmente esta propriedade era definida como um inteiro long. Veja a seção de compatibilidade de browsers para mais detalhes.

Exemplo

Este exemplo mostra as coordenadas do mouse quando você ativar o evento mousemove.

HTML

html
<p>Mova seu mouse para ver sua posicão.</p>
<p id="screen-log"></p>

JavaScript

js
let screenLog = document.querySelector("#screen-log");
document.addEventListener("mousemove", logKey);

function logKey(e) {
  screenLog.innerText = `
    Screen X/Y: ${e.screenX}, ${e.screenY}
    Client X/Y: ${e.clientX}, ${e.clientY}`;
}

Resultado

Especificações

Specification
UI Events
# dom-mouseevent-clienty

Compatibilidade com navegadores

Veja também