
核取方塊的操作大致分為三類:讀取目前狀態、設定某幾個為勾選、以及批次處理。以下依情境整理常用寫法。
$("input:checkbox:checked").val();
$("input[type='checkbox']:checked").val();
$("input[name='ck']:checked").val();
三種寫法效果相同,差別只在選取範圍:第一種是全域、第二種同上但寫法較明確、第三種限定在 name 為 ck 的群組。實務上建議一律加上 context 限定,避免誤抓其他表單:
$("#myForm input[name='ck']:checked").val();
// 逐個走訪
$('input:checkbox').each(function() {
if ($(this).prop('checked')) {
alert($(this).val());
}
});
// 串接成字串
$('input:checkbox').map(function() {
return $(this).val();
}).get().join(',');
注意第二段範例少了 :checked,會把所有核取框的值都串起來。要只取勾選的,應寫成:
$('input:checkbox:checked').map(function() {
return $(this).val();
}).get().join(',');
// 第一個
$('input:checkbox:first').prop('checked', true);
$('input:checkbox').eq(0).prop('checked', true);
// 最後一個
$('input:checkbox:last').prop('checked', true);
// 依索引
$('input:checkbox').eq(index).prop('checked', true);
// 連續多個(第 1、2 個)
$('input:checkbox').slice(0, 2).prop('checked', true);
// 依 value
$("input:checkbox[value='1']").prop('checked', true);
// 全選 $('input:checkbox').prop('checked', true); // 全部取消 $('input:checkbox').prop('checked', false);用
.each()逐個設定的舊寫法仍然可行,但.prop()直接作用在整個集合上,程式碼短得多。5. 移除元素
// 移除 value 為 1 的 $("input:checkbox[value='1']").remove(); // 移除第三個 $("input:checkbox").eq(2).remove();6. 遍歷
$('input:checkbox').each(function(index, domEle) { // index 是索引,domEle 是原生 DOM 元素 });最重要的觀念:attr 與 prop 之別
上面所有範例原本都寫成
.attr('checked', 'checked'),這在 jQuery 1.6 之後是錯誤的。兩者的差異是:
attr() 操作的是 HTML 屬性字串,反映的是「頁面初始載入時的狀態」。prop() 操作的是 DOM 物件的當前狀態屬性,反映的是「使用者互動後的實際狀態」。checked、selected、disabled 這類屬於「狀態」而非「屬性」,一律該用 prop()。混用會導致很典型的 bug:勾選方塊在畫面上明明被取消了,用 attr('checked') 讀卻仍回傳 "checked"。
// 正確的讀取方式
$(this).prop('checked'); // 回傳 boolean
$(this).is(':checked'); // 等價寫法
// 正確的設定方式
$(this).prop('checked', true);
若只是全選/取消,用原生 API 反而更短,也不必依賴 jQuery:
document.querySelectorAll('#myForm input[type=checkbox]').forEach(function(cb) {
cb.checked = true;
});
// 取得勾選的值
[...document.querySelectorAll('#myForm input[type=checkbox]:checked')]
.map(cb => cb.value);