Layui table 初始化时让指定行 checkbox 默认勾选，需在原始数据对象中设置 layChecked: true 字段，仅对 type: 'checkbox' 列生效，且必须为布尔值 true；异步加载时后端须在每条数据中返回该字段，不可置于顶层或传字符串/数字。
layui table 初始化时让指定行 checkbox 默认勾选
直接在 data 数组里加 laychecked: true 字段，layui 会自动识别并渲染为已选状态。这不是靠 js 后续操作 dom 实现的，而是初始化阶段的数据驱动行为。
常见错误是试图用 table.checkStatus 拿到实例再手动 checkRow，或者等 render 完再遍历 tr 去 click —— 这两种都容易失效，尤其在开启分页、异步加载或使用 url 配置时，DOM 可能还没生成或已被重绘。
-
layChecked必须写在原始数据对象里，不是列配置项，也不是表格参数 - 只对
checkbox类型的列生效（即type: 'checkbox'的列） - 如果用了
url异步加载，后端返回的 JSON 数组每项需包含"layChecked": true - 注意布尔值要传
true，别传字符串"true"或数字1，否则不认
示例数据片段：
[
{ "id": 1, "username": "张三", "layChecked": true },
{ "id": 2, "username": "李四", "layChecked": false },
{ "id": 3, "username": "王五" }
]
layui table 使用 url 加载时后端怎么返回默认选中数据
后端返回的 JSON 数据结构必须保持和 Layui 文档要求一致，且在每条记录里带上 layChecked 字段。Layui 不解析额外字段，但会检查这个键名是否存在且为真值。
典型错误是后端把 layChecked 放在顶层（如 {"data": [...], "count": 10, "layCheckedIds": [1,3]}），这完全无效 —— Layui 只看数组每一项内部有没有该字段。
- 字段名严格为
layChecked，大小写不能错 - 值为
true才生效；false、null、undefined都视为未选中 - 若用 Java/Spring Boot，确保序列化器（如 Jackson）没忽略该字段（检查
@JsonIgnore或 getter） - Node.js + Egg/Koa 中，确认返回前没做字段过滤（比如用
pick剔除了它）
动态渲染后想补选某些行（非初始化场景）
初始化之后再操作 checkbox，只能走 table.setRowChecked 或 table.checkRow，但要注意：它们只对当前页有效，且依赖表格实例和正确索引。
最常踩的坑是混淆「数据索引」和「表格行索引」——比如第 3 条数据在第 2 页第 1 行，你传 index: 2（以为是全局第 3 条）就错了，得传当前页内真实行号（从 0 开始）。
- 优先用
table.setRowChecked，它接受dataIndex（即原始数据数组下标），更可靠 - 如果数据已重排或分页，先用
table.cache['yourId']拿到当前页缓存数据，再找对应位置 - 不要在
done回调外直接调用，确保表格已完成渲染（可用table.on('render', ...)监听） - 批量操作时避免循环调用
setRowChecked，性能差；可先改table.cache再触发重绘（但需谨慎）
自定义 checkbox 列时 layChecked 失效怎么办
如果你删掉了默认 type: 'checkbox' 列，自己用 templet 写了个带 <input type="checkbox"> 的列，那 layChecked 就完全不起作用了 —— Layui 只对内置 checkbox 列做自动绑定。
这时候得手动同步状态：在 templet 里读取 layChecked 字段控制 checked 属性，并监听点击更新 table.cache 和选中状态。
- templet 示例：
<input type="checkbox" {{ d.layChecked ? "checked" : "" }}> - 必须配合
event属性绑定点击事件，不然勾选不会影响checkStatus结果 - 别忘了在事件处理里调用
table.checkRow或更新cache，否则导出、全选等逻辑会错乱 - 这种写法绕过了 Layui 的 checkbox 管理机制，后续维护成本明显升高
真正需要自定义样式时，更稳妥的做法是用 CSS 覆盖默认 checkbox，而不是重写 HTML 结构。
