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
103
104
105
106
|
---
title: Document.write()
slug: Web/API/Document/write
tags:
- API
- DOM
- Method
- Reference
translation_of: Web/API/Document/write
---
<div>{{ApiRef("DOM")}}</div>
<p>O método <strong><code>Document.write()</code></strong> grava uma sequência de caracteres em um documento aberto por {{domxref("document.open()")}}.</p>
<div class="note"><strong>Nota</strong>: à medida que <code>document.write</code> grava no <strong>fluxo</strong> de documentos, chamando <code>document.write</code> em um documento fechado (carregado) invoca automaticamente <code>document.open</code>, <a href="/en-US/docs/Web/API/document.open#Notes">que limpará o documento</a>.</div>
<h2 id="Sintaxe">Sintaxe</h2>
<pre class="brush: js notranslate"><var>document</var>.write(<var>markup</var>);
</pre>
<h3 id="Parametros">Parametros</h3>
<dl>
<dt><var>markup</var></dt>
<dd>Uma string contendo o texto a ser gravado no documento.</dd>
</dl>
<h3 id="Exemplo">Exemplo</h3>
<pre class="brush: html notranslate"><html>
<head>
<title>Escreva exemplo</title>
<script>
function newContent() {
document.open();
document.write("<h1>Sair com o velho - entrar com o novo!</h1>");
document.close();
}
</script>
</head>
<body onload="newContent();">
<p>Algum conteúdo do documento original.</p>
</body>
</html>
</pre>
<p>{{EmbedLiveSample("Syntax")}}</p>
<h2 id="Notas">Notas</h2>
<p>Escrevendo em um documento que já foi carregado sem chamar {{domxref("document.open()")}} automaticamente vai chamar <code>document.open</code>. Ao términno da escrita, é recomendável chamar {{domxref("document.close()")}} para dizer ao navegador para encerrar o carregamento da página. O texto que você escreve é analisado no modelo de estrutura do documento. No exemplo acima, o elemento <code>h1</code> se torna um nó (node) no documento.</p>
<p>Se chamar <code>document.write()</code> incorporada em uma tag HTML <code><script></code> embutida, então <code>document.open()</code> não será chamada. Por exemplo:</p>
<pre class="brush: html notranslate"><script>
document.write("<h1>Título principal</h1>")
</script>
</pre>
<div class="note"><strong>Nota</strong>: <code>document.write</code> e {{domxref("document.writeln")}} <a href="/en-US/docs/Archive/Web/Writing_JavaScript_for_HTML">não funcionam em documentos XHTML</a> (você receberá o erro "Operation is not supported" [<code>NS_ERROR_DOM_NOT_SUPPORTED_ERR</code>] no console de erros). Isso acontece ao abrir um arquivo local com a extensão .xhtml ou em qualquer documento exibido com um MIME type <code>application/xhtml+xml</code> {{Glossary("MIME type")}}. Mais informações disponíveis em <a class="external" href="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite">W3C XHTML FAQ</a>.</div>
<div class="note"><strong>Nota</strong>: <code>document.write</code> em <a href="/en-US/docs/Web/HTML/Element/script#attr-defer">deferred</a> ou <a href="/en-US/docs/Web/HTML/Element/script#attr-async">asynchronous</a> scripts será ignorado, e você receberá uma mensagem como "A call to <code>document.write()</code> from an asynchronously-loaded external script was ignored" no console de erros.</div>
<div class="note"><strong>Nota</strong>: Somente no Edge, chamando <code>document.write</code> mais de uma vez em {{HTMLElement("iframe")}} causa o erro "SCRIPT70: Permission denied".</div>
<div class="note"><strong>Nota</strong>: A partir de 55, Chrome não executará elementos <code><script></code> injetados via <code>document.write()</code> caso haja falta de cache HTTP para usuários em uma conexão 2G. Há <a href="https://developers.google.com/web/updates/2016/08/removing-document-write">uma lista de condições </a>que precisam ser atendidas para que isso seja verdade.</div>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Especificações</th>
<th scope="col">Status</th>
<th scope="col">Comentario</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("HTML WHATWG", "#dom-document-write", "document.write(...)")}}</td>
<td>{{Spec2("HTML WHATWG")}}</td>
<td></td>
</tr>
<tr>
<td>{{SpecName("DOM2 HTML", "html.html#ID-75233634", "document.write(...)")}}</td>
<td>{{Spec2("DOM2 HTML")}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
<div>{{Compat("api.Document.write")}}</div>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li>{{domxref("element.innerHTML")}}</li>
<li>{{domxref("document.createElement()")}}</li>
</ul>
|
