萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript document.write() 輸出樣式完整指南

基本用法回顧

document.write() 是 JavaScript 最早期的 DOM 操作方法之一,用於直接向文檔流寫入內容。雖然現代開發較少直接使用,但理解其特性對維護舊專案、動態生成廣告代碼、第三方腳本嵌入仍有價值。

樣式輸出的三種模式

1. 行內樣式直接輸出

// 基礎寫法
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>');

缺點:樣式與內容耦合,維護困難,代碼冗長難讀。

2. 類別選擇器模式(推薦)

// 輸出帶有 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>

優點:結構與樣式分離,易於維護、支援響應式設計、可複用樣式類別。

3. 完整樣式表注入

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>\
');

適用場景:第三方嵌入式元件(聊天窗口、評論系統、廣告位),確保樣式隔離不污染宿主頁面。

引號轉義最佳實踐

在字串串接中混合單雙引號極易出錯,建議採用統一策略:

  • 外層使用單引號,內層 HTML 屬性用雙引號(符合 HTML 標準)
  • 需在字串中輸出雙引號時,使用 \" 轉義
  • 模板字面量(ES6 ` `)可避免轉義困擾,支援多行與插值
// 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 重新開始寫入
  • 阻塞解析:同步執行,延遲頁面渲染
  • XSS 風險:若輸入包含用戶可控資料,務必進行 HTML 轉義
  • 不支援模組化:無法搭配 ES Modules、TypeScript 類型檢查

現代替代方案

需求推薦替代方案
動態插入 HTMLelement.innerHTML、element.insertAdjacentHTML()、DocumentFragment
建立元素節點document.createElement() + appendChild()
第三方腳本載入<script async/defer>、動態 createElement('script')
樣式隔離Shadow DOM、CSS Modules、CSS-in-JS 方案

總結

document.write() 是歷史遺留 API,現代前端開發應優先採用 DOM API 或框架提供的渲染機制。若必須使用(如舊廣告代碼整合),請嚴格遵循:僅在文檔解析階段同步調用、輸出內容嚴格轉義、樣式採用類別選擇器模式,並規劃遷移路徑。

copyright © 萬盛學電腦網 all rights reserved