document.write() 是 JavaScript 最早期的 DOM 操作方法之一,用於直接向文檔流寫入內容。雖然現代開發較少直接使用,但理解其特性對維護舊專案、動態生成廣告代碼、第三方腳本嵌入仍有價值。
// 基礎寫法
document.write('<span style="font-size: 20px; font-family: Helvetica; color: #333;">動態內容</span>');
// 變數插值
var userName = "訪客";
document.write('<div style="padding: 10px; background: #f0f0f0;">歡迎,' + userName + '</div>');
缺點:樣式與內容耦合,維護困難,代碼冗長難讀。
// 輸出帶有 class 的元素
document.write('<div id="dynamic-content" class="promo-banner">限時優惠</div>');
配合外部/內部 CSS:
<style>
.promo-banner {
padding: 15px 20px;
background: linear-gradient(135deg, #ff6b6b, #ee5a24);
color: white;
border-radius: 8px;
font-weight: 600;
text-align: center;
box-shadow: 0 4px 15px rgba(238, 90, 36, 0.3);
}
#dynamic-content {
max-width: 600px;
margin: 0 auto;
}
</style>
優點:結構與樣式分離,易於維護、支援響應式設計、可複用樣式類別。
document.write('\
<style>\
.injected-widget { border: 1px solid #ddd; border-radius: 4px; padding: 16px; }\
.injected-widget h3 { margin-top: 0; color: #2c3e50; }\
</style>\
<div class="injected-widget">\
<h3>動態載入的元件</h3>\
<p>此樣式隨元件一同注入</p>\
</div>\
');
適用場景:第三方嵌入式元件(聊天窗口、評論系統、廣告位),確保樣式隔離不污染宿主頁面。
在字串串接中混合單雙引號極易出錯,建議採用統一策略:
\" 轉義` `)可避免轉義困擾,支援多行與插值// ES6 寫法(現代瀏覽器支援)
const user = { name: "小明", level: "VIP" };
document.write(`
<div class="user-card">
<span class="name">${user.name}</span>
<span class="badge badge-${user.level.toLowerCase()}">${user.level}</span>
</div>
`);
window.onload 後呼叫 document.write() 會清空 document 重新開始寫入| 需求 | 推薦替代方案 |
|---|---|
| 動態插入 HTML | element.innerHTML、element.insertAdjacentHTML()、DocumentFragment |
| 建立元素節點 | document.createElement() + appendChild() |
| 第三方腳本載入 | <script async/defer>、動態 createElement('script') |
| 樣式隔離 | Shadow DOM、CSS Modules、CSS-in-JS 方案 |
document.write() 是歷史遺留 API,現代前端開發應優先採用 DOM API 或框架提供的渲染機制。若必須使用(如舊廣告代碼整合),請嚴格遵循:僅在文檔解析階段同步調用、輸出內容嚴格轉義、樣式採用類別選擇器模式,並規劃遷移路徑。