萬盛學電腦網

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

JavaScript Checkbox 全選/反選/取消全選:三種經典實現模式完整解析

表單中「全選」Checkbox 是高頻需求。本文梳理三種經典實現模式:基本全選、主從聯動(子選中父選中)、表單對象遍歷,並提供現代化最佳實踐與無障礙增強方案。

模式一:基礎全選/取消(按 name 分組)

function checkAll(name) {
  var inputs = document.getElementsByTagName('input');
  for (var i = 0; i < inputs.length; 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; i < inputs.length; 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" />

模式二:主從聯動(父選中→全選子,子全選→父選中)

<input type="checkbox" id="master" onclick="toggleAll(this)" /> 全選
<input type="checkbox" name="items" />
<input type="checkbox" name="items" />
<input type="checkbox" name="items" />

<script>
function toggleAll(master) {
  var slaves = document.getElementsByName('items');
  for (var i = 0; i < slaves.length; i++) {
    slaves[i].checked = master.checked;
  }
}

// 子項變化時更新父項
var slaves = document.getElementsByName('items');
for (var i = 0; i < slaves.length; i++) {
  slaves[i].onclick = function() {
    var allChecked = true;
    for (var j = 0; j < slaves.length; j++) {
      if (!slaves[j].checked) { allChecked = false; break; }
    }
    document.getElementById('master').checked = allChecked;
  };
}
</script>

模式三:表單對象屬性遍歷(舊式寫法)

<form name="form">
  <input type="checkbox" name="id" value="" /> 1
  <input type="checkbox" name="id" value="" /> 2
  <input type="checkbox" name="chose" onclick="selectAll()" /> 全選
</form>

<script>
function selectAll() {
  var form = document.form;
  var master = form.chose;
  var items = form.id; // 同名元素自動成為類數組
  
  if (!items.length) { // 單個元素時不是數組
    items.checked = master.checked;
  } else {
    for (var i = 0; i < items.length; i++) {
      items[i].checked = master.checked;
    }
  }
}
</script>

現代化最佳實踐(推薦)

1. 使用 querySelectorAll + forEach

function toggleAll(masterCheckbox, slaveSelector) {
  var slaves = document.querySelectorAll(slaveSelector);
  slaves.forEach(function(slave) {
    slave.checked = masterCheckbox.checked;
  });
}

// 子項變化監聽
document.querySelectorAll(slaveSelector).forEach(function(slave) {
  slave.addEventListener('change', function() {
    var allChecked = Array.from(document.querySelectorAll(slaveSelector))
      .every(function(s) { return s.checked; });
    masterCheckbox.checked = allChecked;
    masterCheckbox.indeterminate = !allChecked && 
      Array.from(document.querySelectorAll(slaveSelector)).some(function(s) { return s.checked; });
  });
});

2. indeterminate 狀態:視覺化「部分選中」

// 當部分子項選中時,父項顯示「減號/方塊」而非勾選
masterCheckbox.indeterminate = true; // 僅視覺效果,不影響 checked 值

3. jQuery 版本(兼容舊項目)

$('#master').click(function() {
  $('input[name="items"]').prop('checked', this.checked);
});

$('input[name="items"]').click(function() {
  var $items = $('input[name="items"]');
  var allChecked = $items.filter(':checked').length === $items.length;
  $('#master').prop('checked', allChecked);
});

完整無障礙(ARIA)增強版

<fieldset>
  <legend>選擇項目</legend>
  <label>
    <input type="checkbox" id="master" aria-controls="item1 item2 item3" /> 全選
  </label>
  <ul>
    <li><label><input type="checkbox" name="items" id="item1" value="1" /> 項目 1</label></li>
    <li><label><input type="checkbox" name="items" id="item2" value="2" /> 項目 2</label></li>
    <li><label><input type="checkbox" name="items" id="item3" value="3" /> 項目 3</label></li>
  </ul>
</fieldset>

<script>
var master = document.getElementById('master');
var slaves = document.querySelectorAll('input[name="items"]');

master.addEventListener('change', function() {
  slaves.forEach(function(s) { s.checked = master.checked; });
});

slaves.forEach(function(s) {
  s.addEventListener('change', function() {
    var checkedCount = document.querySelectorAll('input[name="items"]:checked').length;
    master.checked = checkedCount === slaves.length;
    master.indeterminate = checkedCount > 0 && checkedCount < slaves.length;
  });
});
</script>

常見坑點

問題原因解決
單個 checkbox 時 items 不是數組document.form.id 返回單元素用 querySelectorAll 或檢查 .length
動態添加的 checkbox 不生效事件綁定在初始化時事件委託或重新綁定
disabled 狀態被誤操作未檢查 disabled 屬性循環中加 if(!el.disabled)
表單提交包含未選中的值未選中 checkbox 不提交值隱藏字段預設值或後端處理

總結

現代項目推薦:querySelectorAll + forEach + indeterminate 狀態 + ARIA 屬性。避免使用 document.form.name 等舊式 DOM 0 級屬性,語義不清且易出錯。

copyright © 萬盛學電腦網 all rights reserved