結果是把所有匹配元素內的文字串接起來成為一個字串。這個方法對 HTML 與 XML 文件都有效。
<p><b>Test</b> Paragraph.</p><p>Paraparagraph</p>
$("p").text(); // "Test Paragraph.Paraparagraph"
行為類似 html(),但會把 HTML 轉義——< 與 > 會被換成對應的 HTML 實體,所以字串會以純文字呈現。
<p>Test Paragraph.</p>
$("p").text("<b>Some</b> new text.");
// [ <p><b>Some</b> new text.</p> ] ← 畫面上會看到 <b> 這幾個字
這正是前面提到的安全寫法:只要顯示使用者輸入,一律用 text()。
取得第一個匹配元素的 value。自 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
$("input").val(); // 文字框的值,例如 "some text"
為所有匹配元素設定 value,jQuery 1.2 之後也能設定 select 的選中項。
$("input").val("hello world!");
$("#single").val("Single2"); // 單選 select
$("#multiple").val(["Multiple2", "Multiple3"]); // 多選 select
$("input").val(["check2", "radio1"]); // checkbox / radio
最後這個形式很實用:checkbox 與 radio 群組也可以傳陣列一次設定多個勾選狀態,不必自己一個一個 attr("checked", true)。不過如前所述,jQuery 1.6 之後判斷與設定勾選狀態建議改用 prop(),val() 在這方面的行為是正確的,混用 attr 才容易出問題。