jQuery 處理元素內容主要用兩個方法。text() 針對純文字,html() 則能處理 HTML 標記。兩者都有讀取與設定兩種形態,行為卻不完全對稱。
// 把 ID 為 b5_a 的段落內容設為純文字
$('#b5_a').text("這是新加入的文本信息");
// 在 ID 為 b5_b 的 div 裡插入一段 HTML
$("#b5_b").html("<p>新加入一個html段落</p>");
差別在於:用 text() 設定時,內容會被視為純文字,其中的角括號會被轉義後原樣顯示;用 html() 設定時,內容會被當標記解析。
// 讀取純文字
$("button:eq(1)").click(function(){
alert($('#b5_a').text());
});
// 讀取 HTML 原始碼
$("button:eq(3)").click(function(){
alert($('#b5_a').html());
});
兩者回傳的都是字串。這裡有個不對稱之處值得記住:設定時 html() 會套用到所有匹配元素,讀取時卻只回傳第一個元素的內容。
因為取回的一定是字串,數值運算前必須轉換:
<ul id="u2">
<li>12.3</li>
<li>1.5</li>
</ul>
$("button:eq(4)").click(function(){
var sum = 0;
$('li').each(function(index){
sum += parseFloat($(this).text());
});
alert(sum);
});
這裡用 parseFloat 而非 parseInt,因為內容含小數。若誤用 parseInt,12.3 會被截成 12,總和就錯了。
這是一個安全問題,不只是風格問題。凡是內容來自使用者輸入或外部資料,一律用 text()。用 html() 設定未經驗證的內容,等於把 HTML 直接交給瀏覽器解析,這是 XSS 最常見的入口。
// 危險:使用者輸入 <img onerror=...> 就會被執行
$("#out").html(userInput);
// 安全:內容會被當純文字顯示
$("#out").text(userInput);
另一個實務上的差異是效能。text() 只處理文字節點,比 html() 走完整的 HTML 解析快得多。在需要大量更新文字內容的場合(例如即時數字、計時器),用 text() 是更合適的選擇。
如果你確實需要插入 HTML,但內容部分摻雜了不可信的資料,正確做法是先寫入安全的骨架,再用 text() 填入變動的部分,而不是把整段拼成字串丟給 html()。