DIV CSS 佈局教程網

html()、text()、val() 三兄弟:定義、實測與使用時機
編輯:JQuery特效代碼     

讀取或設定元素內容時,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() 寫入未淨化的資料,等於替攻擊者開了一扇門。這個習慣的重要性,遠大於記住三個方法的細節差異。

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