DIV CSS 佈局教程網

搞懂 jQuery 的 html()、text()、val():讀取、寫入與差異全解析
編輯:JQuery特效代碼     

這三個方法幾乎每天都在用,但很多人寫了半年仍會在「什麼時候該用哪一個」上猶豫。以下先把官方定義釐清,再透過實測說明它們真正的差異。

html()

.html() 取得第一個匹配元素的 HTML 內容,包含其中的標籤。.html(val) 則設定每一個匹配元素的 HTML 內容。這個方法不能用在 XML 文件上,但 XHTML 文件可以。

text()

.text() 取得所有匹配元素的文字內容,結果是把各元素的文字串接起來;HTML 與 XML 文件都適用。.text(val) 設定所有匹配元素的文字內容,與 html() 類似,但會把 < 與 > 編碼成 HTML 實體,因此內容會被當成純文字而非標籤。

val()

.val() 取得第一個匹配元素的目前值,.val(val) 設定每一個匹配元素的值。它專門用於表單元素。

實測:html() 與 text() 的真正差別

動手做練習時會發現一個官方文件沒強調的重點:html() 會連子元素的標籤一起取出來,text() 不會。

假設有這樣的結構:

<div id="divShow"><b><i>Write Less Do More</i></b></div>

用 $("#divShow").html() 取得,結果是:

<b><i>Write Less Do More</i></b>

但若用 $("#divShow b i").html(),結果只有純文字 Write Less Do More。而 $("#divShow").text() 無論如何都只會得到 Write Less Do More。

完整驗證範例

<%@ 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());
        var strSel = $("select").val().join(",");
        $("input").val(strSel);
    });
})
</script>
</head>
<body>
<table border="1" bordercolor="#A9A9A9" cellspacing="0">
<tr><td>原內容</td><td>說明</td></tr>
<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><div id="divText">4</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>

三個方法的行為對照

讀取時:html() 讀 HTML(含標籤)、text() 讀純文字(含所有後代節點的文字)、val() 讀表單元素的 value。html() 與 text() 不能用在表單元素上,val() 只能用在表單元素上。

多元素時:html() 與 val() 都只取第一個元素的內容;text() 則會把所有選中元素的文字串接起來——這是最容易忘記的差別。

寫入時:三者作用在選集上時,都會替換所有選中元素的內容。

回呼函式:三者都接受函式作為參數,回傳值會成為最終寫入的內容,可用來依各元素狀態動態決定值。

一個安全提醒

用 .html() 寫入使用者輸入或任何外部資料,等於把那段字串當成 HTML 解析,是 XSS 的典型入口。凡是內容可能來自表單、網址參數或第三方 API,請改用 .text();確實需要插入 HTML 時,先經過 sanitizer 過濾。這個原則比記住三個方法的差異更重要。

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