這三個方法都有「不帶參數取值、帶參數設值」的雙重身分,但適用對象完全不同。用錯不會報錯,卻會得到意料之外的結果。
不帶參數時取得第一個符合元素的內部 HTML,回傳字串;帶參數時設定每個符合元素的內容,回傳 jQuery 物件。不能用在 XML 文件,但 XHTML 可以。
// 讀取
<div><p>Hello</p></div>
$("div").html(); // "<p>Hello</p>"
// 設定
<div></div>
$("div").html("<p>Nice to meet you</p>");
// 結果:<div><p>Nice to meet you</p></div>
注意讀出來的是含標籤的原始 HTML,不是純文字。
不帶參數時取得所有符合元素的文字內容並串接起來,回傳字串;帶參數時設定文字,而且會把 < > 等字元轉成 HTML 實體。
<p><b>Hello</b> fine</p>
<p>Thank you!</p>
$("p").text(); // "HellofineThank you!"
$("p").text("<b>Some</b> new text.");
// 畫面上會直接顯示 <b>Some</b> new text. 這串字,標籤不會生效
正因為會自動轉義,要插入使用者輸入的內容時請一律用 text(),這是最基本的 XSS 防線。
不帶參數時取得第一個符合元素的目前值;jQuery 1.2 之後 select 也支援,多選時回傳陣列。
<select id="single">
<option>Single</option>
<option>Single2</option>
</select>
<select id="multiple" multiple="multiple">
<option selected="selected">Multiple</option>
<option>Multiple2</option>
<option selected="selected">Multiple3</option>
</select>
$("p").append("<b>Single:</b> " + $("#single").val()
+ " <b>Multiple:</b> " + $("#multiple").val().join(", "));
// Single: Single Multiple: Multiple, Multiple3
帶參數時設定值,也能用來勾選 checkbox 與 radio:
$("input").val("hello world!");
option 的顯示文字要用 html() 或 text()。 雖然 <option value="x">顯示文字</option> 有 value 屬性,但畫面上呈現的是標籤之間的文字,不是 value。所以改「顯示文字」要操作內容,改「送出值」才用 val()。
input 的顯示值要用 val()。 <input value="安徽省"> 裡的 value 屬性就是畫面上顯示的內容,所以要用 val() 才能讓瀏覽器同步更新畫面。
一句話記法:html() 管標籤、text() 管文字、val() 管表單值。三個方法都只有在操作第一個符合元素時才會取值,設定則會作用於全部。