DIV CSS 佈局教程網

document.write 用法教學:把內容輸出到頁面
編輯:關於JavaScript     

基本用法

document.write 可以把指定的文字寫入頁面。範例:

<script type="text/javascript">
document.write("我是向頁面輸出的文字!");
</script>

存成 write.html 後以瀏覽器打開,頁面上就會顯示:

我是向頁面輸出的文字!

輸出帶 HTML 標籤的內容

若要輸出的內容本身包含 HTML 標籤,直接在字串中寫入即可,瀏覽器會正常解析:

<script type="text/javascript">
document.write("<h1>我是向頁面輸出的文字!</h1>");
</script>

這樣輸出來的會是一個一級標題,而非字面的 <h1> 文字。

語法解說

document.write 是標準的 JavaScript 指令,用於向網頁輸出字串。要輸出的字元以雙引號或單引號包起來,放入括號中。

如果字串本身含有同類引號,需搭配另一種引號或跳脫字元:

document.write('他說:"你好"');
document.write("他說:\"你好\"");

document.write 的執行時機決定一切

這是使用這個方法時最需要理解的一件事。

頁面解析期間呼叫 document.write,內容會被插入到 script 標籤所在的位置。但在頁面載入完成之後再呼叫,它會清空整個文件再重新寫入,等於把原本的頁面內容全部抹掉。

<button onclick="badExample()">試試看</button>
<script>
function badExample(){
  document.write("你按下按鈕了");
}
</script>

按下這個按鈕,整頁會只剩「你按下按鈕了」六個字,原本的按鈕與其他內容全部消失。

該改用什麼

除了「頁面初次解析時輸出靜態內容」這個狹窄場景,其餘情況都該改用 DOM API:

// 取代 document.write("文字")
document.getElementById("target").textContent = "文字";

// 若要插入 HTML 片段
document.getElementById("target").innerHTML = "<h1>標題</h1>";

// 更安全的做法:建立元素節點
var h1 = document.createElement("h1");
h1.textContent = "標題";
document.getElementById("target").appendChild(h1);

為什麼不建議用 document.write

  • 會拖慢頁面載入。以外部 script 呼叫 document.write 時,瀏覽器必須先下載並執行該腳本,才能知道要寫入什麼,這會阻斷解析器,形成效能瓶頸。現代瀏覽器對此有優化(預先掃描),但仍不如直接寫在 HTML 中。
  • 時機敏感。如上所述,呼叫時機不對就無法復原。
  • XSS 風險。若寫入的內容含有使用者提供的資料,等同直接注入 HTML。務必改用 textContent,或先做完整的轉義。
  • 無法用於非同步情境。在 async 或 defer 載入的腳本中呼叫它,行為難以預測。

document.write 與 alert 都是學習階段的好工具——寫法簡單,能立刻看到結果。但在真實專案中,DOM API 才是該依賴的夥伴。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved