files/pt-br/conflicting/web/api/globaleventhandlers/onscroll/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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

---
title: window.onscroll
slug: Web/API/Window/onscroll
translation_of: Web/API/GlobalEventHandlers/onscroll
translation_of_original: Web/API/Window/onscroll
---
<p>{{ ApiRef() }}</p>
<h3 id="Summary" name="Summary">Sumário</h3>
<p>Especifica a função a ser chamada quando é feito o scroll na janela.</p>
<h3 id="Syntax" name="Syntax">Sintaxe</h3>
<pre class="eval">window.onscroll = <em>funcRef</em>;
</pre>
<ul>
 <li><code>funcRef</code> é uma função de referência.</li>
</ul>
<h3 id="Example" name="Example">Exemplos</h3>
<h4 id="Exemplo_1_Genérico">Exemplo 1: Genérico</h4>
<pre class="brush: js">window.onscroll = function (oEvent) {
  // executa um bloco de código ou funções, quando o scroll é feito na janela.
}
</pre>
<h4 id="Examplo_2_Dectando_a_rolagem">Examplo 2: Dectando a rolagem</h4>
<p>O exemplo a seguir, irá disparar um <code><a href="/pt-BR/docs/DOM/window.alert" title="/pt-BR/docs/DOM/window.alert">alerta</a></code> sempre que o usuário rolar a página .</p>
<pre class="brush: html">&lt;!doctype html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /&gt;
&lt;title&gt;onscroll test&lt;/title&gt;
&lt;script type="text/javascript"&gt;
window.onscroll = scroll;

function scroll () {
 alert("evento scroll detectado! " + window.pageXOffset + " " + window.pageYOffset);
 // nota: você pode usar window.innerWidth e window.innerHeight para obter a largura e altura da área de visão.
}
&lt;/script&gt;
&lt;/head&gt;

&lt;body&gt;
&lt;p&gt;Redimensione a janela&lt;/p&gt;
&lt;p&gt;para um tamanho pequeno,&lt;/p&gt;
&lt;p&gt;e use a barra de rolagem&lt;/p&gt;
&lt;p&gt;para mover ao redor do conteúdo da página&lt;/p&gt;
&lt;p&gt;na janela.&lt;/p&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>
<h4 id="Examplo_3_Mostra_um_link_no_topo_da_página_depois_da_rolagem.">Examplo 3: Mostra um link no topo da página depois da rolagem.</h4>
<p>O exemplo a seguir irá mostrar um link( uma imagem de seta ) no topo da página quando a rolagem vertical atingir 500 pixels</p>
<p> </p>
<pre class="brush: html">&lt;!doctype html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /&gt;
&lt;title&gt;MDN Example&lt;/title&gt;
&lt;script type="text/javascript"&gt;
var bAppended = false, oBookmark = document.createElement("div");
oBookmark.id = "arrowUp";
oBookmark.innerHTML = "&lt;a href=\"#\" title=\"Top of the page.\"&gt;&amp;uarr;&lt;\/a&gt;";

onscroll = function() {
  var nVScroll = document.documentElement.scrollTop || document.body.scrollTop;
  bAppended = nVScroll &gt; 500 ?
    bAppended || (document.body.appendChild(oBookmark), true)
    : bAppended &amp;&amp; (document.body.removeChild(oBookmark), false);
};
&lt;/script&gt;
&lt;style type="text/css"&gt;
#arrowUp {
  position: fixed;
  height: auto;
  width: auto;
  right: 10px;
  top: 10px;
  font-size: 48px;
}
#arrowUp a {
  text-decoration: none;
  color: black;
  font-weight: bold;
  font-family: serif;
}
&lt;/style&gt;
&lt;/head&gt;

&lt;body&gt;
&lt;p&gt;Conteúdo da página aqui!&lt;/p&gt;
&lt;/body&gt;

&lt;/html&gt;</pre>
<h3 id="Notes" name="Notes">Notas</h3>
<p>{{ Bug(189308) }}, nas versões antigas do Gecko, o evento 'onscroll' era executado apenas quando a barra de rolagem era arrastada, não quando utilizada a seta do teclado ou scroll do mouse.<br>
 Esse bug foi corrigido no Gecko 1.8/Firefox 1.5</p>
<p>Quando o window.scrollX/scrollY não é 0 -- considerando que o scroll ocorreu por algum script ou uma ação manual -- recarregando a página irá disparar o evento onscroll imediatamente.</p>
<h3 id="Specification" name="Specification">Especificação</h3>
<ul>
 <li><a class="external" href="http://www.w3.org/TR/html5/webappapis.html#event-handlers-on-elements-document-objects-and-window-objects" title="http://www.w3.org/TR/html5/webappapis.html#event-handlers-on-elements-document-objects-and-window-objects">HTML5: Event handlers on elements, Document objects, and Window objects</a></li>
</ul>
<p>{{ languages( { "zh-cn": "zh-cn/DOM/window.onscroll"} ) }}</p>