萬盛學電腦網

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

JavaScript 實現 Checkbox 全選/全不選:通用封裝函數與現代化寫法

表單批量操作的核心交互。本文提供通用的 checkAll(name)/clearAll(name) 封裝函數,支援按 name 分組操作,並展示現代 querySelectorAll + forEach 寫法與「主從聯動」增強邏輯。

基礎封裝函數(兼容舊瀏覽器)

// 全選
function checkAll(name) {
  var inputs = document.getElementsByTagName('input');
  for (var i = 0, len = inputs.length; i < len; i++) {
    if (inputs[i].type === 'checkbox' && inputs[i].name === name) {
      inputs[i].checked = true;
    }
  }
}

// 全不選
function clearAll(name) {
  var inputs = document.getElementsByTagName('input');
  for (var i = 0, len = inputs.length; i < len; i++) {
    if (inputs[i].type === 'checkbox' && inputs[i].name === name) {
      inputs[i].checked = false;
    }
  }
}

// HTML 調用
<input type="checkbox" id="selectAll" 
       onclick="if(this.checked){checkAll('productId')}else{clearAll('productId')}" /> 全選
<input type="checkbox" name="productId" value="1" />
<input type="checkbox" name="productId" value="2" />
<input type="checkbox" name="productId" value="3" />

現代化寫法(推薦)

// 通用切換函數
function toggleCheckboxes(name, checked) {
  document.querySelectorAll('input[type="checkbox"][name="' + name + '"]')
    .forEach(function(el) {
      if (!el.disabled) el.checked = checked;
    });
}

// 全選
function checkAll(name) { toggleCheckboxes(name, true); }
// 全不選
function clearAll(name) { toggleCheckboxes(name, false); }

// 主從聯動:父控制子
function setupMasterSlave(masterSelector, slaveSelector) {
  var master = document.querySelector(masterSelector);
  var slaves = document.querySelectorAll(slaveSelector);
  
  master.addEventListener('change', function() {
    slaves.forEach(function(s) { 
      if (!s.disabled) s.checked = master.checked; 
    });
  });
  
  slaves.forEach(function(s) {
    s.addEventListener('change', function() {
      var checkedCount = document.querySelectorAll(slaveSelector + ':checked').length;
      master.checked = checkedCount === slaves.length;
      master.indeterminate = checkedCount > 0 && checkedCount < slaves.length;
    });
  });
}

// 初始化
setupMasterSlave('#selectAll', 'input[name="productId"]');

jQuery 版本(舊項目維護)

// 全選/取消
function toggleAll(name, check) {
  $('input[type="checkbox"][name="' + name + '"]').prop('checked', check);
}

// 主從聯動
$('#master').change(function() {
  $('input[name="items"]').prop('checked', this.checked);
});

$('input[name="items"]').change(function() {
  var $items = $('input[name="items"]');
  var checked = $items.filter(':checked').length;
  $('#master').prop('checked', checked === $items.length)
              .prop('indeterminate', checked > 0 && checked < $items.length);
});

進階:獲取已選值(表單提交用)

function getCheckedValues(name) {
  return Array.from(document.querySelectorAll('input[type="checkbox"][name="' + name + '"]:checked'))
    .map(function(el) { return el.value; });
}

// 使用
var selectedIds = getCheckedValues('productId'); // ["1", "3", "5"]
console.log(selectedIds.join(',')); // 後端接收字串或數組

無障礙增強

<fieldset>
  <legend>商品選擇</legend>
  <label>
    <input type="checkbox" id="master" aria-controls="p1 p2 p3" /> 全選
  </label>
  <ul>
    <li><label><input type="checkbox" name="productId" id="p1" value="1" /> 商品 1</label></li>
    <li><label><input type="checkbox" name="productId" id="p2" value="2" /> 商品 2</label></li>
  </ul>
</fieldset>

總結

核心邏輯:querySelectorAll 精準選擇 → forEach 批量設置 checked。現代寫法簡潔、語義清晰、天然支援 indeterminate 狀態。舊項目維護用 getElementsByName + 循環即可。

copyright © 萬盛學電腦網 all rights reserved