MouseEvent.clientY

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

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 (en-US).

HTML

html

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

JavaScript

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

Especificação	Status	Comentário
CSS Object Model (CSSOM) View Module The definition of 'clientY' in that specification.	Rascunho atual	Redefine `MouseEvent` de `long` para `double`.
Document Object Model (DOM) Level 3 Events Specification The definition of 'MouseEvent.clientY' in that specification.	Obsoleto	Sem mudanças vindas de Document Object Model (DOM) Level 2 Events Specification.
Document Object Model (DOM) Level 2 Events Specification The definition of 'MouseEvent.clientY' in that specification.	Obsoleto	Definição inicial.

Compatibilidade com navegadores

BCD tables only load in the browser