files/pt-br/web/api/htmlelement/offsettop/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

---
title: HTMLElement.offsetTop
slug: Web/API/HTMLElement/offsetTop
tags:
  - API
  - ApenasLeitura
  - Propriedade
translation_of: Web/API/HTMLElement/offsetTop
---
<div>
<div>{{ APIRef("HTML DOM") }}</div>
</div>

<p>O <strong><code>HTMLElement.offsetTop</code></strong> é um método apenas de leitura que retorna a medida, em pixels, da distância do elemento atual em relação ao topo do {{domxref("HTMLelement.offsetParent","offsetParent")}}.</p>

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

<pre class="syntaxbox"><var>topPos</var> = element.offsetTop;
</pre>

<h3 id="Parameters" name="Parameters">Parâmetros</h3>

<ul>
 <li><code>topPos</code> é o número, em pixels, que representa a distância do elemento para o topo do elemento pai mais próximo posicionado com relative.</li>
</ul>

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

<pre class="brush:js">var d = document.getElementById("div1");
var topPos = d.offsetTop;

if (topPos &gt; 10) {
  // deslocamento em relação ao topo maior
  // que 10pixels do topo
}</pre>

<h2 id="Specification" name="Specification">Especificação</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSSOM View', '#dom-htmlelement-offsettop', 'offsetTop')}}</td>
   <td>{{Spec2('CSSOM View')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibility" name="Compatibility">Compatibilidade do navegador</h2>

<p>{{Compat("api.HTMLElement.offsetTop")}}</p>

<p>Em conformidade com a especificação, essa propriedade retornará <code>null</code> no Webkit se o elemento não estiver sendo exibido (o <code>style.display</code> desse elemento ou ancestral estiver como <code>"none"</code>) ou se o <code>style.position</code> do elemento estiver setado como <code>"fixed"</code>.</p>

<p>Essa propriedade retornará <code>null</code> no Internet Explorer (9) se o <code>style.position</code> do elemento estiver setado como <code>"fixed"</code>. (Ter <code>display:none</code> não afeta esse browser.)</p>