Document.write()
Document.write()
メソッドは、テキストの文字列を document.open()
で開かれた文書ストリームに書き込みます。
メモ: document.write()
は文書のストリームに書き込みを行うため、閉じられた (読み込み済みの) 文書で document.write()
を呼び出すと、自動的に document.open()
が呼び出され、文書はクリアされます。
構文
document.write(markup);
引数
- markup
-
文書に書き込まれるテキストを含む文字列です。
例
<html>
<head>
<title>書き込み例</title>
<script>
function newContent() {
document.open();
document.write("<h1>新しい内容では、古い内容は削除されます!</h1>");
document.close();
}
</script>
</head>
<body onload="newContent();">
<p>元の文書コンテンツ。</p>
</body>
</html>
注
出力したテキストは文書構造モデルにおいて構文解析されます。上記の例では、 h1
要素は文書中の一つのノードになります。
document.open()
を呼び出さずに読み込まれた文書へ書き込みを行うと、自動的に document.open()
の呼び出しが実行されます。一度出力し終わったとき、ブラウザーにページの読み込みの終了を伝えるために、 document.close()
を呼び出すことが推奨されます。
document.write()
の呼び出しがインラインの HTML の <script>
タグ内で行われた場合、 document.open()
は呼び出されません。次に例を示します。
<script>
document.write("<h1>Main title</h1>")
</script>
メモ: document.write()
および document.writeln
は、 XHTML 文書では動作しません (エラーコンソールに "Operation is not supported" [NS_ERROR_DOM_NOT_SUPPORTED_ERR
] エラーが表示されます)。これは、 .xhtml の拡張子を持つローカルファイルを開いたり、何らかの文書が application/xhtml+xml
の MIME タイプで提供されたときに発生します。詳細は W3C XHTML FAQ で確認することができます。
メモ: document.write
は deferred または asynchronous のスクリプト内では無視され、エラーコンソールに "A call to document.write()
from an asynchronously-loaded external script was ignored" などのメッセージが表示されます。
メモ: Edge のみ、document.write()
を <iframe>
内で複数回呼び出すと、 SCRIPT70: Permission denied エラーが発生します。
メモ: Chrome 55 からは、キャッシュされていない HTTP の場合、document.write()
を通じて挿入された <script>
要素は実行されなくなります。これが成立するのに必要な条件の一覧については、document.write() に対する介入をご覧ください。
仕様書
Specification |
---|
HTML Standard # dom-document-write-dev |
ブラウザーの互換性
BCD tables only load in the browser