aboutsummaryrefslogtreecommitdiff
path: root/files/id/web/api/document/write/index.html
blob: ac3912c415ad38a8f3685e662e5e8b369bba4ec6 (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
---
title: Document.write()
slug: Web/API/Document/write
tags:
  - API
  - DOM
  - Method
  - Reference
translation_of: Web/API/Document/write
---
<div>{{ ApiRef("DOM") }}</div>

<p>Menuliskan teks string ke sebuah dokumen stream yang dibuka dengan <a href="/en-US/docs/Web/API/document.open">document.open()</a>.</p>

<div class="note">Catatan: ketika <code>document.write</code> menulis ke dokumen <strong>stream</strong>, memanggil <code>document.write</code> pada sebuah dokumen tertutup (termuat), dokumen secara otomatis memanggil <code>document.open</code>, <a href="https://developer.mozilla.org/en-US/docs/Web/API/document.open#Notes">yang akan menghapus dokumen</a>.</div>

<h2 id="Sintaks">Sintaks</h2>

<pre class="brush: js">document.write(<em>markup</em>);
</pre>

<p><code>markup</code> merupakan sebuah string yang berisi teks untuk ditulis ke dalam dokumen.</p>

<h3 id="Contoh">Contoh</h3>

<pre class="brush: html">&lt;html&gt;

&lt;head&gt;
&lt;title&gt;write example&lt;/title&gt;

&lt;script&gt;

function newContent()
{
alert("load new content");
document.open();
document.write("&lt;h1&gt;Out with the old - in with the new!&lt;/h1&gt;");
document.close();
}

&lt;/script&gt;
&lt;/head&gt;

&lt;body onload="newContent();"&gt;
&lt;p&gt;Some original document content.&lt;/p&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>

<h2 id="Catatan">Catatan</h2>

<p>Menulis ke sebuah dokumen yang telah dimuat tanpa memanggil <a href="/id/docs/Web/API/document.open"><code>document.open()</code></a> akan secara otomatis melakukan panggilan <code>document.open</code>. Setelah selesai menulis, disarankan untuk memanggil <a href="/en-US/docs/Web/API/document.close"><code>document.close()</code></a>, untuk meminta browser untuk menyelesaikan memuat halaman. Teks yang anda tulis akan di parse ke dalam stuktur model dokumen tersebut. Pada contoh diatas, elemen <code>h1</code> menjadi sebuah node pada document.</p>

<p>Jika pemanggilan <code>document.write()</code> merpakan embeded pada inline tag html <code>&lt;script&gt;</code> tag, maka tidak akan memanggil <code>document.open()</code>. Sebagai contoh:</p>

<pre class="brush: html">&lt;script&gt;
  document.write("&lt;h1&gt;Main title&lt;/h1&gt;")
&lt;/script&gt;
</pre>

<div class="note"><strong>Catatan:</strong> <code>document.write</code> an <code>document.writeln</code> <a href="/en-US/docs/Archive/Web/Writing_JavaScript_for_HTML">tidak berfungsi di dokumen XHTML</a> ( anda akan mendapat peringatan "Operation is not supported" [<code>NS_ERROR_DOM_NOT_SUPPORTED_ERR</code>] error pada konsole). Ini terjadi ketika membuka sebuah file lokal dengan ekstensi file .xhtml atau dokumen lain yang disajikan dengan <a href="/en-US/docs/Glossary/MIME_type">MIME type</a> <code>application/xhtml+xml</code> . Informasi lengkap tersedia di <a class="external" href="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite">W3C XHTML FAQ</a>.</div>

<div class="note"><strong>Catatan:</strong> <code>document.write</code> pada script <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-defer">deferred</a> atau <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-async">asynchronous</a> akan diabaikan, dan anda mendapatkan peringatan error "A call to <code>document.write()</code> from an asynchronously-loaded external script was ignored" pada konsole.</div>

<h2 id="Spesifikasi">Spesifikasi</h2>

<ul>
 <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634">DOM Level 2 HTML: <code>write()</code> Method</a></li>
 <li><a class="external" href="http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion">Dynamic markup insertion in HTML</a></li>
</ul>

<h2 id="Lihat_juga">Lihat juga</h2>

<ul>
 <li>{{ domxref("element.innerHTML") }}</li>
 <li>{{ domxref("document.createElement()") }}</li>
</ul>