讀取或設定元素內容時,jQuery 提供了三個看起來很像的方法。釐清它們的分工,能省下不少 debug 的時間。
html():取得第一個匹配元素的 HTML 內容;html(val) 設定每一個匹配元素的 HTML 內容。不能用於 XML 文件,但 XHTML 文件可以。
text():取得所有匹配元素的內容,結果由各元素包含的文字串接而成,HTML 與 XML 文件都適用;text(val) 設定所有匹配元素的文字內容,與 html() 類似,但會把 < 與 > 編碼成對應的 HTML 實體。
val():取得第一個匹配元素的目前值;val(val) 設定每一個匹配元素的值。
做練習時會發現 html() 與 text() 還有一個關鍵不同:html() 取值時會把子元素的標籤一併帶出來,text() 不會。
given 這樣的結構:
<div id="divShow"><b><i>Write Less Do More</i></b></div>
var strHTML = $("#divShow").html(); 得到:
<b><i>Write Less Do More</i></b>
var strHTML2 = $("#divShow b i").html(); 得到純文字 Write Less Do More。
而 var strText = $("#divShow").text(); 同樣只有 Write Less Do More——text() 沒有「連標籤一起取」這種情況。
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<% String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<script src="js/jquery.js" type="text/javascript"></script>
<title>獲取或設定元素的內容</title>
<style type="text/css">
body { font-size: 15px; text-align: center; }
div { border: solid 0px #666; padding: 5px; width: 220px; margin: 5px; }
</style>
<script type="text/javascript">
$(function () {
var strHTML = $("#divShow").html(); // 含子元素的兩個標籤
var strHTML2 = $("#divShow b i").html(); // 不含標籤
var strHTML3 = $("div").html(); // 只取第一個匹配元素
var strText = $("#divShow").text(); // 純文字
var strText2 = $("div").text(); // 所有匹配元素串接
$("#divHTML").html(strHTML);
$("#divHTML2").html(strHTML2);
$("#divHTML3").html(strHTML3);
$("p").html(strHTML);
$("#divText").text(strText);
$("#divText2").text(strText2);
$("a").text(strText);
$("select").change(function () {
alert($("select").val()); // 取列表框選中項的值
$("input").val($("select").val().join(","));
});
})
</script>
</head>
<body>
<table border="1" bordercolor="#A9A9A9" cellspacing="0">
<tr>
<td><div id="divShow"><b><i>Write Less Do More</i></b></div></td>
<td>這是原內容(帶格式)</td>
</tr>
<tr>
<td><div id="divHTML">1</div></td>
<td>連帶格式取出後以 html 輸出</td>
</tr>
<tr>
<td><div id="divHTML2">2</div></td>
<td>不帶格式取出後以 html 輸出</td>
</tr>
<tr>
<td><div id="divHTML3">3</div></td>
<td>只取第一個匹配元素的內容</td>
</tr>
<tr>
<td><p></p></td>
<td>以 html 方式設定段落內容</td>
</tr>
<tr>
<td><div id="divText">4</div></td>
<td>以 text 方式輸出</td>
</tr>
<tr>
<td><div id="divText2"></div></td>
<td>以 text 輸出所有匹配元素的內容</td>
</tr>
<tr>
<td>
<select multiple="multiple" style="height:96px;width:85px">
<option value="1">Item 1</option>
<option value="2">Item 2</option>
<option value="3">Item 3</option>
</select>
<select>
<option value="7">Item 7</option>
<option value="9" selected>Item 9</option>
</select>
</td>
<td>測試 val() 取表單值</td>
</tr>
</table>
</body>
</html>
以上是在 jQuery 1.6 上實測的結果,各位也可以自行驗證。
html() 讀寫元素的 HTML 標籤內容;text() 讀寫元素的純文字;val() 讀寫表單元素的 value。
讀取多元素時:html() 與 val() 只回傳第一個;text() 則串接全部——這是三者最實用的區別。
適用對象:html() 與 text() 不能用在表單元素上,val() 只能用在表單元素上。
寫入時:三者都會作用於選集中的所有元素,且都支援傳入回呼函式,依各元素狀態動態決定寫入的內容。
需要保留格式(粗體、連結、巢狀結構)時用 html();只是要顯示一段純文字時用 text();處理 input、select、textarea 時用 val()。
最後提醒一次:凡是內容來自使用者輸入或外部來源,請一律用 text()。用 html() 寫入未淨化的資料,等於替攻擊者開了一扇門。這個習慣的重要性,遠大於記住三個方法的細節差異。