table.clearCache('yourTableId') 不会清复选框状态，仅清空缓存数据；真正清除需组合操作：清缓存、遍历移除layui-form-checked类、重置selectedIds并调用form.render('checkbox')。
table.clearCache 会清掉复选框状态吗
不会。table.clearcache('yourtableid') 只清空内部缓存的数据对象（即 table.cache['yourtableid']），不影响 dom 上已渲染的 checkbox 状态，也不会移除 layui-form-checked 类。它解决的是「缓存脏数据」问题，不是「ui 状态重置」问题。
真正能一键清除所有复选框勾选态的 API 是什么
没有现成的「一键清除所有页 checkbox 勾选态」的官方 API。Layui 2.8 的 table.checkAll 只作用于当前页，table.setRowChecked 需手动传入行索引或数据项，且不自动同步到其他页——它只改单行 UI 和 cache 中该行的 layChecked 字段，不批量、不跨页。
所谓“一键”，实际是组合动作：
- 调用
table.clearCache('yourTableId')清缓存（可选，防旧数据干扰） - 遍历当前页所有
<tr>，移除 <code>layui-form-checked类 - 重置你维护的全局
selectedIds数组（如window.selectedIds = new Set()） - 如果用了
form.render('checkbox')，需再调一次确保表单状态同步 - 若未显式传
where或page参数，分页器可能跳回第 1 页，但用户正在第 5 页操作，体验断裂 - reload 后 checkbox 的勾选态仍取决于你是否在
done或render回调里手动打钩——它不会自动“清空” - 如果你之前用
table.setRowChecked打过勾，reload 不会自动撤销那些layChecked: true标记，除非你提前清掉 cache 或覆盖原始数据
为什么不能只靠 table.reload 清除勾选态
table.reload() 会重新请求数据、重绘表格，但有三个关键陷阱：
最简可行的一行清除逻辑（带副作用说明）
放在 toolbar 按钮点击事件里，这行代码能清掉当前页所有 checkbox 的视觉勾选和内部标记：
layui.table.cache['yourTableId'].forEach((item, i) => layui.table.setRowChecked('yourTableId', {index: i, checked: false}));
但注意：
- 它只清当前页，
table.cache里存的仍是全量数据（若后端真分页则只有当前页） - 必须确保
table.cache['yourTableId']存在且非空，否则 forEach 报错 - 不会影响你外部维护的
selectedIds，得额外清空，否则翻页后仍会恢复勾选 - 执行后需手动触发
form.render('checkbox')，否则 DOM 上的 class 不更新
跨页状态管理始终是你自己的责任，Layui 不代劳。别指望一个 API 解决全部，重点是把「缓存」「DOM 状态」「业务 ID 列表」三者同步清楚。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
