表單中「全選」Checkbox 是高頻需求。本文梳理三種經典實現模式:基本全選、主從聯動(子選中父選中)、表單對象遍歷,並提供現代化最佳實踐與無障礙增強方案。
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>
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; });
});
});
// 當部分子項選中時,父項顯示「減號/方塊」而非勾選
masterCheckbox.indeterminate = true; // 僅視覺效果,不影響 checked 值
$('#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);
});
<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 級屬性,語義不清且易出錯。