jQuery 提供了很多操作元素內容的方法,但真正需要分清楚的只有三個:.html() 讀寫 HTML 結構、.text() 讀寫純文字、.val() 讀寫表單值。釐清「我到底是想改內容,還是想加一個元素」,是選對方法的前提。
有三種形式:.html()、.html(htmlString)、.html(function(index, html){...})。
$("Element").html();
回傳值是字串。重點:若選擇器命中多個元素,只會讀取第一個,而且此法對 XML 文件無效。
<div class="demo"> <p>這是一個段落元素,裡面包含了一個 a 鏈接元素<a href="#">W3CPLUS</a></p> </div>
$(document).ready(function () {
alert("Div.demo 中的 p 元素的 HTML 結構:" + $("div.demo p").html());
});
結果:

如果 demo 裡有兩個 p 呢?
<div class="demo"> <p>我是 div.demo 中第一個 P 元素:<a href="#">我在第一個 P 裡面</a></p> <p>這是一個段落元素,裡面包含了一個 a 鏈接元素<a href="#">W3CPLUS</a></p> </div>
$(document).ready(function () {
alert("Div.demo 中的 p 元素的 HTML 結構:" + $("div.demo p").html());
});
效果:

同樣的程式碼、不同的結果,正好印證:選擇器命中多個元素時,只有第一個的 HTML 內容會被取出。
$("Element").html(htmlString);
回傳 jQuery 物件。它會把匹配元素的原有內容完全換成新的 HTML 片段。
$(document).ready(function () {
$("div.demo p").html('<h2 class="title">新加的標題</h2><p>我是 div.demo 中第一個 P 元素:<a href="#">我在第一個 P 裡面</a></p>');
});
效果:

注意這裡的行為轉折:讀取時只看第一個,寫入時卻會套用到所有匹配元素,而且每一個都被換成一模一樣的內容。
$("Element").html(function (index, html) {...});
函數會收到兩個參數:目前元素的索引位置(從 0 起算)與它原本的 HTML 內容,回傳值就是新的內容。當你想讓多個元素各自換成不同內容時,這個形式最好用。
<div class="demo"> <p><a href="#">我在第一個 P 裡面</a></p> <p><a href="#">W3CPLUS</a></p> </div>
$(document).ready(function () {
$("div.demo p").html(function (index, oldHtml) {
return "我是段落" + (index + 1) + ":" + oldHtml;
});
});
效果:

$("Element").text();
它會把匹配元素集合中每一個元素(含後代)的文字串接起來,HTML 標籤一律剝除。與 .html() 不同,.text() 在 XML 文件上也能用。由於各家瀏覽器的 HTML 解析器差異,回傳結果中的換行與空白可能略有不同。
<div class="demo"> <p><a href="#">W3CPLUS</a></p> </div>
$(document).ready(function () {
alert(".text() 讀取的內容:" + $("div.demo p").text());
});
效果:

這裡出現一個關鍵差異:.html() 命中多個只讀第一個,.text() 則會讀取全部並合併。
<div class="demo"> <p><a href="#">W3CPLUS</a></p> <p>我是段落二:<a href="#">W3CPLUS</a></p> </div>
$(document).ready(function () {
alert(".text() 方法:" + $("div.demo p").text());
alert(".html() 方法:" + $("div.demo p").html());
});
效果:

$("Element").text(textString);
它與 .html(htmlString) 最大的差別在於:html 會把字串當標籤解析,text 則會把 < 與 > 轉成實體,當成純文字顯示。
$(document).ready(function () {
$("div.demo p").text('<h2 class="title">新加的標題</h2><p>我是 div.demo 中第一個 P 元素</p>');
});
效果:

畫面上會直接看到那串標籤文字。相同之處是:命中多個元素時,一樣會全部換成相同內容。
$("Element").text(function (index, text) {...});
$(document).ready(function () {
$("div.demo p").text(function (index, oldText) {
return (index + 1) + "." + oldText;
});
});
效果:

.html() 與 .text() 都無法作用在 input 上,這時才需要 .val()。
$("Element").val();
回傳字串或陣列。作用在 <select multiple="multiple"> 上時,會回傳一個包含所有被選 option 的陣列。
<div id="colorRadio"> <input type="radio" name="color" id="rd1" value="Red" />Red <input type="radio" name="color" id="rd2" value="Yello" />Yello <input type="radio" name="color" id="rd3" value="Blue" />Blue </div> <div id="sizeCheck"> <input type="checkbox" name="size" id="ch1" value="10 pt" />10 pt <input type="checkbox" name="size" id="ch2" value="12 pt" />12 pt <input type="checkbox" name="size" id="ch3" value="14 pt" />14 pt </div> <input type="button" id="submitBtn" value="Get Value" />
$(document).ready(function () {
$('#submitBtn').click(function () {
alert($('#colorRadio input:radio').val());
alert($('#sizeCheck input:checkbox').val());
});
});
效果:

問題在這裡:.val() 只回傳集合中的第一個元素的值,跟使用者有沒有勾選完全無關。要拿到真正被選中的那一個,必須加上:checked:
$(document).ready(function () {
$('#submitBtn').click(function () {
alert($('input:radio[name=color]:checked').val());
alert($('input:checkbox[name=size]:checked').val());
});
});
單選鈕這樣就夠了,但核取方塊可能同時勾好幾個,此時 .val() 依然只給第一個,一個都沒勾時則回傳 undefined。要全部取出,得用 each() 遍歷:
$(document).ready(function () {
$('#submitBtn').click(function () {
alert($('input:radio[name=color]:checked').val());
$('input:checkbox[name=size]:checked').each(function () {
alert($(this).val());
});
});
});
而 select 也有兩種情況:用在單選 select 上回傳選中的值;用在 multiple 的 select 上回傳包含各選項的陣列。
<form action="" method="post">
<select id="dropdown">
<option>Red</option>
<option>Yellow</option>
<option>Blue</option>
</select>
<select id="listbox" multiple="multiple">
<option>Red</option>
<option>Yellow</option>
<option>Blue</option>
</select>
<input type="button" id="getSelectValue" value="Get Value" />
</form>
$("#getSelectValue").click(function () {
alert($("#dropdown").val());
var colors = $("#listbox").val();
for (var key in colors) {
alert(colors[key]);
}
});
$("Element").val(value);
value 可以是字串,也可以是字串陣列(用於多選 select)。它會把所有匹配元素的值設成相同內容:
$("input").val("test"); // 把所有 input 的值都改成 test
實務上比較少這樣用,更常見的是搭配 focus 與 blur 做提示文字切換:
<input type="text" id="textBox" value="Hello,jQuery!" />
$("input:text").focus(function () {
var val = $(this).val();
if (val == this.defaultValue) {
$(this).val("");
}
});
$("input:text").blur(function () {
var val = $(this).val();
if (val == "") {
$(this).val(this.defaultValue);
}
});
$("Element").val(function (index, value) {...});
<form action="">
<div id="colorRadio">
<input type="radio" name="color" id="rd1" value="Red" /><span>Red</span>
<input type="radio" name="color" id="rd2" value="Yellow" /><span>Yellow</span>
<input type="radio" name="color" id="rd3" value="Blue" /><span>Blue</span>
</div>
<div id="sizeCheck">
<input type="checkbox" name="size" id="ch1" value="10 pt" /><span>10 pt</span>
<input type="checkbox" name="size" id="ch2" value="12 pt" /><span>12 pt</span>
<input type="checkbox" name="size" id="ch3" value="14 pt" /><span>14 pt</span>
</div>
<input type="text" id="txtBox" disabled="disabled" />
<input type="button" id="setValue" value="Set Value" />
</form>
$(document).ready(function () {
$("input:radio[name=color]").val(function (index, oldVal) {
return "color-" + (index + 1) + ":" + oldVal;
});
$("input:checkbox[name=size]").val(function (index, oldVal) {
return "size-" + (index + 1) + ":" + oldVal;
});
$("#setValue").click(function () {
var msg = $("input:radio[name=color]:checked").val() + ",";
$("input:checkbox[name=size]:checked").each(function () {
msg += $(this).val() + ",";
});
$("#txtBox").val(msg);
});
});
多選下拉列表則用陣列指定:
$(document).ready(function () {
$('#dropdown').val('Yellow');
$('#listbox').val(['Red', 'Blue']);
});
功能上的差異可以整理成三點: