---
title: MouseEvent.clientY
slug: Web/API/MouseEvent/clientY
tags:
  - API
  - CSSOM View
  - Eventos de DOM
  - Eventos de mouse
  - Propriedade
  - Somente Leitura
translation_of: Web/API/MouseEvent/clientY
---
<div>{{APIRef("DOM Events")}}</div>

<p>A propriedade <strong><code>clientY</code></strong>  da interface {{domxref("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).</p>

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

<h2 id="Sintaxe">Sintaxe</h2>

<pre class="syntaxbox">var <em>y</em> = <em>instanciaDeEventoDoMouse</em>.clientY
</pre>

<h3 id="Valor_de_retorno">Valor de retorno</h3>

<p><span style="background-color: #ffffff;">O valor retornado por essa propriedade é um valor flutuante </span><span style='background-color: rgba(220, 220, 220, 0.5); font-family: consolas,"Liberation Mono",courier,monospace;'>double</span> como foi redefinida pelo "CSSOM View Module". Originalmente esta propriedade era definida como um inteiro <code>long</code>. Veja a seção de compatibilidade de browsers para mais detalhes.</p>

<h2 id="Exemplo">Exemplo</h2>

<p>Este exemplo mostra as coordenadas do mouse quando você ativar o evento {{Event("mousemove")}}.</p>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;p&gt;Mova seu mouse para ver sua posicão.&lt;/p&gt;
&lt;p id="screen-log"&gt;&lt;/p&gt;</pre>

<h3 id="JavaScript">JavaScript</h3>

<pre class="brush: 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}`;
}</pre>

<h3 id="Resultado">Resultado</h3>

<p>{{EmbedLiveSample("Example")}}</p>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
  <tr>
   <td>{{SpecName('CSSOM View','#dom-mouseevent-clienty', 'clientY')}}</td>
   <td>{{Spec2('CSSOM View')}}</td>
   <td>Redefine {{domxref("MouseEvent")}} de <code>long</code> para <code>double</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM3 Events','#widl-MouseEvent-clientY','MouseEvent.clientY')}}</td>
   <td>{{Spec2('DOM3 Events')}}</td>
   <td>Sem mudanças vindas de {{SpecName('DOM2 Events')}}.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 Events','#Events-MouseEvent','MouseEvent.clientY')}}</td>
   <td>{{Spec2('DOM2 Events')}}</td>
   <td>Definição inicial.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade_de_browser">Compatibilidade de browser</h2>

<div class="hidden">Esta tabela de compatibilidade é gerada de dados estruturais. Se você quiser contribuir para os dados, visite <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos mande uma "pull request"</div>

<p>{{Compat("api.MouseEvent.clientY")}}</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li>{{ domxref("MouseEvent") }}</li>
 <li>{{domxref("MouseEvent.clientX","clientX")}}</li>
 <li>{{domxref("MouseEvent.screenX","screenX")}} / {{domxref("MouseEvent.screenY","screenY")}}</li>
</ul>