aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/document/readystate/index.html
blob: d5d2cea5cd0e3121ca2ed18af59bd5448a6db8ec (plain)
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
100
101
102
---
title: Document.readyState
slug: Web/API/Document/readyState
tags:
  - API
  - HTML DOM
  - Propriedade
  - Referencia
  - eventos
translation_of: Web/API/Document/readyState
---
<div>{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }}</div>

<h2 id="Summary" name="Summary">Sumário</h2>

<p>Retorna "<em>loading</em>" enquanto {{ domxref("document") }} está carregando, "<em>interactive</em>" quando foi carregado porém seus sub-recursos (como imagens, por exemplo) ainda não, e "<em>complete</em>" quando foi totalmente carregado.</p>

<div>O evento <code>readystatechange</code> é acionado no objeto {{ domxref("document") }} quando esse valor é alterado.</div>

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

<pre class="syntaxbox"><em>var string</em> = document.readyState;
</pre>



<h3 id="Valores">Valores</h3>

<p><code>readyState</code> de um documento pode ser um dos seguintes:</p>

<dl>
 <dt><code>loading</code></dt>
 <dd>O {{domxref("document")}} ainda está carregando.</dd>
 <dt><code>interactive</code></dt>
 <dd>O documento terminou de ser carregado e o documento foi analisado, mas sub-recursos, como imagens, folhas de estilo e quadros, ainda estão sendo carregados.</dd>
 <dt><code>complete</code></dt>
 <dd>O documento e todos os sub-recursos terminaram de carregar. O estado indica que o {{event("load")}} evento está prestes a disparar.</dd>
</dl>



<h2 id="Exemplos">Exemplos</h2>

<h3 id="Diferentes_estados_de_readyState">Diferentes estados de readyState</h3>

<pre><code>switch (document.readyState) {
  case "loading":
    // O documento esta carregando
    break;
  case "interactive":
    // O documento acabou de carregar. Nós podemos acessar os elementos do DOM.
    // </code>mas sub-recursos, como imagens, folhas de estilo e quadros, ainda estão sendo carregados.<code>
    var span = document.createElement("span");
    span.textContent = "A &lt;span&gt; element.";
    document.body.appendChild(span);
    break;
  case "complete":
    // A pagina carregou por completo.
    console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText);
    break;
}</code></pre>

<h3 id="readystatechange_como_uma_alternativa_para_DOMContentLoaded_evento">readystatechange como uma alternativa para DOMContentLoaded evento</h3>

<pre><code>// </code>alternativa para DOMContentLoaded evento<code>
document.onreadystatechange = function () {
  if (document.readyState === 'interactive') {
    initApplication();
  }
}</code></pre>

<h3 id="readystatechange_como_uma_alternativa_para_load_evento">readystatechange como uma alternativa para load evento</h3>

<pre><code>// </code>ternativa para load evento<code>
document.onreadystatechange = function () {
  if (document.readyState === 'complete') {
    initApplication();
  }
}</code></pre>

<h3 id="readystatechange_como_ouvinte_de_evento_para_inserir_ou_modificar_o_DOM_antes_de_DOMContentLoaded">readystatechange como ouvinte de evento para inserir ou modificar o DOM antes de DOMContentLoaded</h3>

<pre><code>document.addEventListener('readystatechange', event =&gt; {
  if (event.target.readyState === 'interactive') {
    initLoader();
  }
  else if (event.target.readyState === 'complete') {
    initApp();
  }
});</code></pre>

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

<ul>
 <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#current-document-readiness" title="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#current-document-readiness">http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#current-document-readiness</a></li>
</ul>

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

<ul>
 <li><a href="https://developer.mozilla.org/pt-BR/docs/Web/Events/readystatechange">document.onreadystatechange</a></li>
</ul>