表單是網頁與使用者互動最頻繁的環節,而 radio 與 checkbox 的選值處理,往往也是初學者最容易踩坑的地方。本文把幾個高頻需求——全選、取消全選、選取奇數項、反選、取出所有已勾選的值——整理成一份可以直接套用的範例,並順手說明一個相當典型的跨瀏覽器陷阱。
下面的腳本以五個按鈕對應五種行為,name 屬性統一為 checkbox,因此只要用屬性選擇器就能一次抓到整組元素:
$(document).ready(function(){
$("#btn1").click(function(){
$("[name='checkbox']").attr("checked", true); // 全選
});
$("#btn2").click(function(){
$("[name='checkbox']").removeAttr("checked"); // 取消全選
});
$("#btn3").click(function(){
$("[name='checkbox']:even").attr("checked", true); // 選取索引為偶數的項目
});
$("#btn4").click(function(){ // 反選
$("[name='checkbox']").each(function(){
$(this).attr("checked", !$(this).attr("checked"));
});
});
$("#btn5").click(function(){ // 輸出所有已勾選的值
var str = "";
$("[name='checkbox']:checked").each(function(){
str += $(this).val() + "\r\n";
});
alert(str);
});
});
對應的 HTML 結構相當單純,一組同名的 checkbox 加上五顆觸發用的按鈕即可:
<form name="form1" method="post" action="">
<input type="button" id="btn1" value="全選">
<input type="button" id="btn2" value="取消全選">
<input type="button" id="btn3" value="選中所有奇數">
<input type="button" id="btn4" value="反選">
<input type="button" id="btn5" value="取得選中的所有值">
<br><br>
<input type="checkbox" name="checkbox" value="checkbox1"> checkbox1
<input type="checkbox" name="checkbox" value="checkbox2"> checkbox2
<input type="checkbox" name="checkbox" value="checkbox3"> checkbox3
<input type="checkbox" name="checkbox" value="checkbox4"> checkbox4
<input type="checkbox" name="checkbox" value="checkbox5"> checkbox5
<input type="checkbox" name="checkbox" value="checkbox6"> checkbox6
</form>
不少舊教學會把「取出已勾選項目」寫成下面的形式:
$("[name='checkbox'][checked]").each(function(){
str += $(this).val() + "\r\n";
});
這段寫法在部分瀏覽器上能勉強運作,但在 Firefox 中卻抓不到任何元素。原因在於 [checked] 被當成「屬性(attribute)是否存在」來判斷,而瀏覽器在互動後並不會同步更新 HTML 上的那個屬性,於是不同瀏覽器的行為就出现了分歧。
正確做法是把 [checked] 換成 jQuery 的:checked 偽類選擇器,它讀取的是元素的「當前狀態」:
$("[name='checkbox']:checked").each(function(){
str += $(this).val() + "\r\n";
});
無論 radio 還是 checkbox,:checked 都能穩定取回被選中的元素集合,這是+function 1.2 之後一直沿用的標準寫法。
如果使用的是 jQuery 1.6 以上版本,操作核取方塊時建議改用 prop()。checked 本質上是 DOM 的「property」而不是「attribute」,用 prop() 讀寫可以避免上述歧異:
$("[name='checkbox']").prop("checked", true); // 全選
$("[name='checkbox']").prop("checked", false); // 取消全選
if ($("#chk1").prop("checked")) { // 判斷是否勾選
// ...
}
// 取值時仍建議搭配 :checked
$("[name='checkbox']:checked").each(function(){
console.log($(this).val());
});
小結:勾選狀態的「設定」用 prop(),「讀取」用 :checked,這組搭配在現代專案中是最不容易出錯的組合。