DIV CSS 佈局教程網

jQuery html() 無法顯示內容?IE8 以下限制與 html()、innerHTML 的差別
編輯:JQuery特效代碼     

把一段 HTML 字串塞進元素時,若內容是空的,而改用原生 innerHTML 卻正常,這種狀況幾乎都指向同一個原因:jQuery 的 html() 在做的事,比你想的多。

問題現場

$("#content").html(data.content);                  // 沒反應
$("#content")[0].innerHTML = data.content;         // 可以顯示

這個現象出現在載入一份完整的 HTML 郵件內容(含 <html>、<head>、<style>、<script> 標籤)時。原始案例中的內容是一封 newsletter,結構龐大且包含外部樣式與追蹤腳本。

根本原因:html() 不是 innerHTML 的單純包裝

這是最多人誤解的一點。$("#content").html(str) 在內部並不只是 element.innerHTML = str。jQuery 會先用 clean() 函式對字串做預處理,目的包括:

  • 把字串包進合適的容器標籤(依內容是 tr、td、option 等決定包裹方式,因為某些元素不能直接設 innerHTML)。
  • 移除或搬移 <script> 標籤,改以 eval 或動態插入的方式執行。
  • 處理 IE 上 innerHTML 的已知 bug(例如無法設定 table 相關元素)。
  • 清理 <head>、<title> 等不該出現在 body 內的標籤。

當字串是一份完整的 HTML 文件(有 doctype、html、head、body)時,這套清洗流程的結果就不在任何人的預期之內——jQuery 試圖把整份文件塞進一個 div,各瀏覽器的解析結果分歧,最終可能得到空字串。而 innerHTML 是瀏覽器原生的賦值,不做任何判斷,於是「勉強」塞了進去。

IE8 以下的具體限制

在 IE8(含)以下的瀏覽器中,被設定內容若含以下任一情形,html() 會失效:

  1. 引用外部 JS,如 <script src="Stone.js"></script>——設定無效。
  2. 內含 JS 程式碼,如 function Stone(){ alert("我叫MT"); }——設定無效。
  3. 內含 CSS 規則,如 .Stone ul li{ list-style:none; float:left; }——設定無效。

補充一個相關現象:若內容中引用外部樣式表(<link href="../Css/style.css" rel="stylesheet">),HTML 本身能插入,但被引用的 CSS 不會生效,畫面會是無樣式的。原因是 <link> 插入到 body 內的行為在各瀏覽器上並不一致,IE 尤其嚴格。

原因無他:這些標籤(script、style、link)本就不屬於 body 的內容。瀏覽器的 HTML 解析器遇到它們時會依位置的合法性做不同處理,而 jQuery 的清洗流程正是試圖補齊這些差異——在能力不足的舊 IE 上,補齊的結果就是整段放棄。

正確解法

一、不要把整份 HTML 文件當片段插入。取 body 內的內容就好:

var $doc = $($.parseHTML(data.content));
$("#content").html($doc.find("body").html() || $doc.filter("div").html());

$.parseHTML() 是專為此設計的 API,它解析字串並回傳節點陣列,不執行 script、也不做 html() 那些額外假設。

二、CSS 要另外處理。把樣式規則抽出來,插入到 <head> 中的 style 標籤:

$("head").append('<style>' + cssText + '</style>');

三、需要執行 script 時,手動建立 script 元素。動態插入的 script 才會被執行:

$.each(content.match(/<script[^>]*>([\s\S]*?)<\/script>/g) || [], function (i, tag) {
    var code = tag.replace(/<\/?script[^>]*>/g, "");
    var s = document.createElement("script");
    s.text = code;
    document.head.appendChild(s);
});

但要強調:動態執行插入的 script 是 XSS 的主要途徑。若內容來自使用者或其他不可信來源,這段程式碼絕對不能存在。

四、檢查編碼。原案例中內容含中文且宣告 charset=gb2312,若 Ajax 回應的解碼與頁面不一致,也可能導致解析異常。確認回應標頭的 Content-Type 帶了正確的 charset。

今天的做法

這個問題幾乎是歷史遺跡——IE11 都已在 2022 年退役,html() 的舊 IE 分支早已不是考量。若你現在遇到「html() 沒反應而 innerHTML 可以」,排查方向應該是:

  • 內容是否為完整 HTML 文件而非片段(最常見)。
  • 是否含 <script> 而被 jQuery 剝離執行(內容看似消失,其實是被搬走了)。
  • 資料是否為 null/undefined——.html(null) 的行為與 .html("") 不同,前者在某些版本會被當成「讀取」而非「設定」。
  • 選擇器是否選到了元素。$("#content") 若不存在,一切呼叫都是安靜的空操作,不報錯也不生效。這是「什麼都沒發生」最常見的原因。

而若你只是想把文字放進去,永遠記得:純文字用 .text(),它會自動轉義,既不會有解析問題,也不會有 XSS 風險。

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