批量操作資料時,「全選/取消全選」是高頻需求。本文提供三種實作模式:原生 JS 邏輯、現代 ES6 簡潔寫法、不可變資料流模式(適合 Vue/React),並解決「全選狀態同步」難題。
indeterminate = false。indeterminate = false。indeterminate = true(顯示為橫槓/半選狀態)。<form id="batchForm">
<label><input type="checkbox" id="selectAll"> 全選/取消</label>
<fieldset id="items">
<label><input type="checkbox" name="ids" value="1"> 項目 1</label>
<label><input type="checkbox" name="ids" value="2"> 項目 2</label>
<label><input type="checkbox" name="ids" value="3"> 項目 3</label>
</fieldset>
</form>
<script>
const form = document.getElementById('batchForm');
const selectAll = document.getElementById('selectAll');
const items = form.querySelectorAll('input[name="ids"]');
// 1. 點擊全選框 → 切換所有子項
selectAll.onclick = () => {
const checked = selectAll.checked;
items.forEach(cb => cb.checked = checked);
selectAll.indeterminate = false;
};
// 2. 點擊子項 → 更新全選框狀態
items.forEach(cb => {
cb.onchange = () => {
const checkedCount = [...items].filter(c => c.checked).length;
selectAll.checked = checkedCount === items.length;
selectAll.indeterminate = checkedCount > 0 && checkedCount < items.length;
};
});
</script>
class CheckboxGroup {
constructor(selectAllSel, itemSel) {
this.selectAll = document.querySelector(selectAllSel);
this.items = [...document.querySelectorAll(itemSel)];
this.bind();
}
bind() {
this.selectAll.addEventListener('click', () => this.toggleAll());
this.items.forEach(cb => cb.addEventListener('change', () => this.sync()));
}
toggleAll() {
const checked = this.selectAll.checked;
this.items.forEach(cb => cb.checked = checked);
this.selectAll.indeterminate = false;
}
sync() {
const checked = this.items.filter(cb => cb.checked);
this.selectAll.checked = checked.length === this.items.length;
this.selectAll.indeterminate = checked.length > 0 && checked.length < this.items.length;
}
getSelectedValues() {
return this.items.filter(cb => cb.checked).map(cb => cb.value);
}
}
// 使用
const group = new CheckboxGroup('#selectAll', 'input[name="ids"]');
// 取得勾選值:group.getSelectedValues()
<script setup>
import { ref, computed } from 'vue';
const allItems = ref([
{ id: 1, label: '專案 Alpha' },
{ id: 2, label: '專案 Beta' },
{ id: 3, label: '專案 Gamma' },
]);
const selectedIds = ref([]);
// 計算屬性自動同步 indeterminate
const isAllSelected = computed(() => selectedIds.value.length === allItems.value.length);
const isIndeterminate = computed(() => selectedIds.value.length > 0 && !isAllSelected.value);
function toggleAll() {
if (isAllSelected.value) {
selectedIds.value = [];
} else {
selectedIds.value = allItems.value.map(i => i.id);
}
}
function submit() {
console.log('提交 IDs:', selectedIds.value);
}
</script>
<template>
<label>
<input type="checkbox" v-model="selectedIds" :value="item.id" v-for="item in allItems" :key="item.id">
{{ item.label }}
</label>
<label>
<input type="checkbox" :checked="isAllSelected" :indeterminate="isIndeterminate" @change="toggleAll">
全選
</label>
<button @click="submit">批量處理</button>
</template>
掌握狀態同步邏輯,全選功能就能既簡潔又健壯。