萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery CheckBox 復選框操作完整指南:選取、遍歷、全選與進階技巧

jQuery 操作 CheckBox 復選框完整實戰手冊

表單中 CheckBox 的操作是前端開發高頻需求。本文系統整理 12 種常見操作場景,從基礎值獲取到進階批次處理,提供標準化、可維護的 jQuery 實作方案。

基礎選取器語法

// 標準選取器
$('input:checkbox')           // 所有 checkbox
$('input[type="checkbox"]')   // 屬性選取器寫法
$('input[name="ck"]')         // 指定 name 群組

12 種核心操作場景完整實作

1. 獲取單個被選中的值(三種寫法)

// 寫法一:標準偽類選取器
$('input:checkbox:checked').val();

// 寫法二:屬性選取器
$('input[type="checkbox"]:checked').val();

// 寫法三:指定 name 群組
$('input[name="ck"]:checked').val();

2. 獲取多個被選中的值(陣列)

// 方式一:each 迴圈收集
var values = [];
$('input:checkbox:checked').each(function() {
  values.push($(this).val());
});

// 方式二:map 映射(更簡潔)
var values = $('input:checkbox:checked').map(function() {
  return this.value;
}).get(); // 返回原生陣列

// 方式三:逗號分隔字串
var csv = $('input:checkbox:checked').map(function() {
  return this.value;
}).get().join(',');

3. 設定第一個為選中狀態

// 現代 prop() 方法(jQuery 1.6+ 推薦)
$('input:checkbox:first').prop('checked', true);

// 或使用 eq()
$('input:checkbox').eq(0).prop('checked', true);

4. 設定最後一個為選中狀態

// 注意:原文誤用 :radio,此處修正為 :checkbox
$('input:checkbox:last').prop('checked', true);
$('input:checkbox').eq(-1).prop('checked', true);

5. 依索引值設定任意項選中

// 單一索引
$('input:checkbox').eq(索引值).prop('checked', true);

// 範圍選取(索引 1 到 2,含頭不含尾)
$('input:checkbox').slice(1, 3).prop('checked', true);

6. 同時選中多個指定項

// 選中第 1、2 項(索引 0,1)
$('input:checkbox').slice(0, 2).prop('checked', true);

7. 依 Value 值設定選中

$('input:checkbox[value="1"]').prop('checked', true);

8. 依 Value 值移除元素

$('input:checkbox[value="1"]').remove();

9. 依索引移除元素

// 移除第 3 個(索引 2)
$('input:checkbox').eq(2).remove();

10. 遍歷所有 CheckBox

$('input:checkbox').each(function(index, domEle) {
  // index: 索引值
  // domEle: 原生 DOM 元素
  // this: 同 domEle
  console.log(index, this.value, this.checked);
});

11. 全選功能

// 標準全選
$('input:checkbox').prop('checked', true);

// 若有「全選」主控制 checkbox
$('#selectAll').on('change', function() {
  $('input:checkbox').not(this).prop('checked', this.checked);
});

12. 全不選功能

$('input:checkbox').prop('checked', false);

關鍵最佳實踐總結

操作類型推薦方法避免使用
設定/讀取 checked 狀態.prop('checked', true/false).attr('checked', ...)
判斷是否選中.is(':checked') 或 .prop('checked').attr('checked')
事件綁定.on('change', handler).click()、內聯 onclick
值獲取.val().attr('value')

進階應用:表單資料序列化

// 將表單所有 checkbox 整理為物件
var formData = {};
$('input:checkbox').each(function() {
  var name = this.name;
  if (!formData[name]) formData[name] = [];
  if (this.checked) formData[name].push(this.value);
});
console.log(formData); // { "colors": ["red", "blue"], "sizes": ["M"] }

常見坑點與避雷指南

  • attr vs prop:jQuery 1.6+ 後,布林屬性(checked、disabled、selected)必須用 .prop(),.attr() 僅獲取初始 HTML 屬性值
  • :checkbox vs [type=checkbox]:前者為 jQuery 擴展偽類(較快),後者為標準 CSS 選取器(較慢但標準)
  • 動態新增元素:使用事件委託 $(document).on('change', 'input:checkbox', handler)
  • 表單提交:未勾選的 checkbox 不會隨表單提交,後端需預設處理
copyright © 萬盛學電腦網 all rights reserved