JavaScript实现复选框全选、全不选和反选
详细讲解如何使用原生JavaScript实现复选框的全选、全不选和反选功能。涵盖checked布尔属性的核心控制机制、主控复选框与子选项的双向联动、indeterminate半选状态管理以及基于事件委托的性能优化。
element.checked,并在各个子项变化时反向推导主控复选框的完整选中、部分选中(indeterminate 半选)与未选中状态。本文将从底层属性机制、三种操作的基础实现、双向联动闭环以及事件委托性能优化四个层次,给出可直接在生产中复用的完整方案。
一、复选框状态控制的核心机制
初学者在操作复选框时,最容易出现的失误是混淆了 HTML 标签特性(Attribute) 与 DOM 对象属性(Property)。理解这两者的本质区别,是编写稳健复选框逻辑的前提。
1. 为什么不能使用 setAttribute('checked')?
在 HTML 规范中,标签内声明的 <input type="checkbox" checked> 仅仅决定了页面初次载入时的“默认值”(对应 DOM 对象的 defaultChecked 属性)。当用户在界面中点击了该复选框后,其界面状态已经脱离了 HTML 属性的控制,转由浏览器内部的活动内存状态管理。
如果使用 element.setAttribute('checked', 'checked') 或 element.removeAttribute('checked'),修改的仅仅是 DOM 节点上的特性标记,并不会动态更新已经经过用户交互的复选框勾选状态。因此,必须直接赋值布尔属性:element.checked = true 或 element.checked = false。
2. 认识半选状态:indeterminate
在现代 UI 设计中,当子列表中只有部分项目被选中时,表头的主控复选框通常需要显示一条横杠(即半选/部分选中态)。许多开发者试图在 HTML 源码中寻找 indeterminate 标签,但事实上 HTML 语法中根本不存在此属性。
indeterminate 是一个纯粹由 JavaScript 提供的 DOM 视觉布尔属性:
element.indeterminate = true:浏览器将渲染半选横杠样式(即便此时element.checked为false)。element.indeterminate = false:清除横杠视觉,恢复正常的空白或对勾表现。
二、三种基础操作的实现原理与代码
在实现操作之前,我们需要先通过选择器获取所有的目标子选项复选框。推荐使用 document.querySelectorAll() 获取静态的 NodeList 集合。
1. 全选 (Select All)
全选的目标是将集合中的每一个子复选框的 checked 属性强制置为 true。如果存在主控复选框,还需将其 indeterminate 重置为 false 并勾选。
// 获取所有子复选框并设为 true
function selectAll() {
const items = document.querySelectorAll('.item-checkbox');
items.forEach(item => {
item.checked = true;
});
}
2. 全不选 (Deselect All)
全不选即清空所有勾选项,将每一个子复选框的 checked 属性置为 false。
// 获取所有子复选框并设为 false
function deselectAll() {
const items = document.querySelectorAll('.item-checkbox');
items.forEach(item => {
item.checked = false;
});
}
3. 反选 (Invert Selection)
反选的逻辑是“原先选中的变为未选,原先未选的变为选中”。这可以直接借助 JavaScript 的逻辑非操作符(!)对当前状态进行布尔取反:
// 对当前 checked 状态取反
function invertSelection() {
const items = document.querySelectorAll('.item-checkbox');
items.forEach(item => {
item.checked = !item.checked;
});
}
三、实现主控复选框与子选项的双向联动闭环
在实际业务场景中,单纯提供三个独立按钮往往不够,通常需要表格顶部的“主控复选框”与所有数据行形成双向联动:
- 下行联动(主控 → 子项):用户勾选或取消主控复选框时,所有子选项跟随主控状态批量变更。
- 上行联动(子项 → 主控):用户逐个勾选子选项时,系统自动统计选中数量,动态决定主控复选框呈现“全选”、“半选”还是“全不选”。
双向联动实现的核心算法
反推主控状态的关键是计算当前已被选中的子项总数 checkedCount 与子项总数 total:
function updateMasterCheckbox() {
const master = document.querySelector('#checkAll');
const items = document.querySelectorAll('.item-checkbox');
const total = items.length;
// 空列表保护
if (total === 0) {
master.checked = false;
master.indeterminate = false;
return;
}
// 统计已勾选数量
let checkedCount = 0;
items.forEach(item => {
if (item.checked) checkedCount++;
});
if (checkedCount === total) {
// 分支 1:全部选中
master.checked = true;
master.indeterminate = false;
} else if (checkedCount === 0) {
// 分支 2:全部未选
master.checked = false;
master.indeterminate = false;
} else {
// 分支 3:部分选中(半选状态)
master.checked = false;
master.indeterminate = true;
}
}
在大多数现代浏览器的默认样式中,只要 element.indeterminate = true,无论此时 element.checked 为 true 还是 false,视觉上都会显示为“横杠(半选)”。为了逻辑严谨且便于表单提交数据判断,在进入半选状态时,建议显式设置 master.checked = false。
四、完整可运行代码与交互演示
以下将 HTML、CSS 和原生 JavaScript 整合为一份可以直接运行的交互示例,同时支持顶部工具栏按钮操作与表头主复选框联动:
| 编号 | 商品名称 | 单价 (元) | 库存状态 | |
|---|---|---|---|---|
| #1001 | 机械键盘 87键茶轴 | ¥ 399.00 | 现货充足 | |
| #1002 | 人体工学无线鼠标 | ¥ 189.00 | 现货充足 | |
| #1003 | 4K Type-C 显示器 27英寸 | ¥ 1,899.00 | 仅剩 3 件 | |
| #1004 | 铝合金双轴便携支架 | ¥ 69.00 | 现货充足 |
完整 JavaScript 实现源码
// 1. 获取核心 DOM 节点
const masterCheckbox = document.querySelector('#demo-master-check');
const tableBody = document.querySelector('#demo-item-body');
const itemCheckboxes = document.querySelectorAll('.demo-item');
const btnSelectAll = document.querySelector('#demo-btn-all');
const btnDeselectAll = document.querySelector('#demo-btn-none');
const btnInvert = document.querySelector('#demo-btn-invert');
const summaryText = document.querySelector('#demo-summary-text');
// 2. 状态更新函数(上行反推)
function syncMasterState() {
const items = document.querySelectorAll('.demo-item');
const total = items.length;
const checkedCount = Array.from(items).filter(item => item.checked).length;
if (checkedCount === 0) {
masterCheckbox.checked = false;
masterCheckbox.indeterminate = false;
} else if (checkedCount === total) {
masterCheckbox.checked = true;
masterCheckbox.indeterminate = false;
} else {
masterCheckbox.checked = false;
masterCheckbox.indeterminate = true;
}
// 更新文本提示
let stateLabel = masterCheckbox.indeterminate ? '半选中' : (masterCheckbox.checked ? '全选' : '未选');
summaryText.textContent = `当前状态:${checkedCount} / ${total} 项已勾选 (主控:${stateLabel})`;
}
// 3. 下行联动:点击表头主控复选框
masterCheckbox.addEventListener('change', function() {
const isChecked = this.checked;
itemCheckboxes.forEach(item => {
item.checked = isChecked;
});
masterCheckbox.indeterminate = false;
syncMasterState();
});
// 4. 事件委托:统一监听列表容器内的复选框变更
tableBody.addEventListener('change', function(e) {
if (e.target && e.target.classList.contains('demo-item')) {
syncMasterState();
}
});
// 5. 按钮组操作绑定
btnSelectAll.addEventListener('click', function() {
itemCheckboxes.forEach(item => item.checked = true);
syncMasterState();
});
btnDeselectAll.addEventListener('click', function() {
itemCheckboxes.forEach(item => item.checked = false);
syncMasterState();
});
btnInvert.addEventListener('click', function() {
itemCheckboxes.forEach(item => item.checked = !item.checked);
syncMasterState();
});
// 初始化状态
syncMasterState();
五、关键避坑指南与性能优化
在面对数据项庞大(例如上千行数据表格)或动态增删节点的需求时,实现方式的优劣会对页面渲染性能和内存开销产生明显影响。
| 考量维度 | 易错 / 低效做法 | 推荐最佳实践 | 原因解析 |
|---|---|---|---|
| 属性操作 | setAttribute('checked', 'checked') |
el.checked = true |
特性标记只影响初始默认属性,DOM 布尔属性才能直接操作真实视图内存。 |
| 事件监听 | 监听 click 事件 |
监听 change 事件 |
change 在勾选动作完全确定后触发,能够天然兼容键盘(空格触发)与无障碍设备。 |
| 监听器挂载 | 为每一个 <input> 分别绑定 addEventListener |
在父容器(如 <tbody>)使用事件委托 |
单监听器节约内存开销;当表格异步加载下一页或删除行时,无需重新绑定事件。 |
| 高阶数组操作 | 直接在 querySelectorAll 上调用 filter |
先转换为真实数组 Array.from(nodeList) |
NodeList 虽有 forEach,但缺少 filter、every、map 等高级方法。 |
针对万级大列表的遍历优化建议
当复选框数量超过数千行时,避免在每次单选变更时都执行完整的全列表循环。可以通过维护一个整数计数器 checkedCounter 进行增量计算:
- 子复选框变为
true时:checkedCounter++; - 子复选框变为
false时:checkedCounter--; - 直接利用
checkedCounter === total和checkedCounter === 0进行 $O(1)$ 常数时间复杂度的状态判定,消除卡顿。
六、总结与开发自查清单
复选框的批量控制逻辑虽然基础,但它涵盖了 DOM 属性机制、三态视觉模型、双向事件流以及事件委托等核心前端知识点。完成编码后,可通过以下清单快速自查:
- [ ] 是否直接使用了
checkbox.checked = true / false而非 HTML 属性操作? - [ ] 主控复选框是否在部分选中时正确设置了
indeterminate = true? - [ ] 主控复选框在“全选”或“全不选”时,是否显式重置了
indeterminate = false? - [ ] 列表如果存在分页或动态新增项,是否采用了事件委托或者在数据更新后刷新了联动状态?
- [ ] 监听的事件类型是否统一使用了
change事件?
HTML引入JS的三种方式:内联、外部文件与ES Module
2026-11-19 08:15:46
怎么解决JS自动轮播首尾切换突兀?无缝无限循环实现方案
2026-11-18 21:57:49
移动端H5 JS抽奖转盘适配:高清屏绘制与触摸事件处理
2026-11-18 19:53:26
JS怎么遍历form.elements获取所有输入项的值
2026-11-18 19:42:54
JS实时监听input输入并获取最新值的方法
2026-11-18 19:20:39








