DIV CSS 佈局教程網

jQuery 操作 CheckBox 完整整理:選取、全選、取值與刪除
編輯:JavaScript綜合知識     

核取方塊的操作大致分為三類:讀取目前狀態、設定某幾個為勾選、以及批次處理。以下依情境整理常用寫法。

1. 取得單一勾選項的值

$("input:checkbox:checked").val();
$("input[type='checkbox']:checked").val();
$("input[name='ck']:checked").val();

三種寫法效果相同,差別只在選取範圍:第一種是全域、第二種同上但寫法較明確、第三種限定在 name 為 ck 的群組。實務上建議一律加上 context 限定,避免誤抓其他表單:

$("#myForm input[name='ck']:checked").val();

2. 取得多個勾選項

// 逐個走訪
$('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(',');

3. 勾選特定項目

// 第一個
$('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);

4. 全選與全不選

// 全選
$('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);
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved