Layui如何让表格的某一行不可勾选

作者:袖梨 2026-07-04
必须用templet自定义checkbox列并显式写disabled,因内置{type:'checkbox'}列不支持按行禁用;需手动生成<input type="checkbox">,保留name="layTableCheckbox",动态添加disabled和checked属性,并在table.checkStatus()后手动过滤有效选中项。

必须用 templet 自定义 checkbox 列并显式写 disabled

内置 {type: 'checkbox'} 列不支持按行禁用,直接写 disabled: true 在数据里完全无效。唯一可靠方式是删掉原 checkbox 列,改用普通列 + templet 模板手动生成 <input type="checkbox">,并在模板中根据当前行数据(如 d.status === 'closed')动态插入 disabled 属性。

关键点:

  • name="layTableCheckbox" 必须保留,这是 Layui 内部识别多选行的硬性约定,漏掉就无法被 table.checkStatus() 识别
  • 要同时控制 disabledchecked,不能只靠 d.layChecked 字段——它不会自动映射到 DOM 的 checked 状态
  • 禁用逻辑必须基于 d(当前行数据),比如 {{# if(d.status === 'closed'){ }} disabled {{# } }},不能依赖外部变量或异步结果

示例模板:

<script type="text/html" id="checkboxTpl"><input type="checkbox" name="layTableCheckbox"   {{# if(d.status === 'closed'){ }} disabled {{# } }}   {{# if(d.layChecked){ }} checked {{# } }}></script>

table.checkStatus() 仍会返回被禁用的行

Layui 不会过滤掉 disabled 的 checkbox,table.checkStatus('demo').data 里照样包含这些行。你拿到的“已勾选数据”其实是假的,必须手动筛。

正确做法:

  • 先取缓存:const cache = table.cache['demo']
  • 再过滤真正可选且已勾选的行:cache.filter(d => d.status !== 'closed' && d.LAY_CHECKED)(注意字段名是 LAY_CHECKED,不是 layChecked
  • 全选判断不能看 res.count,得比对:validChecked.length === cache.filter(d => d.status !== 'closed').length

监听 checkbox 事件时必须拦截禁用项

光加 disabled 属性不够。用户点击全选框后,禁用行的 checkbox 状态不会变,但 table.on('checkbox(test)') 仍可能触发(取决于是否真渲染了 input)。稳妥做法是在事件回调开头加判断:

table.on('checkbox(test)', function(obj){  if (obj.disabled) return;  // 后续逻辑});

否则后续处理会把禁用行当成有效选中项参与计算,导出、批量操作都可能出错。

禁用只是 UI 层遮蔽,Layui 状态管理完全 unaware

这是最易被忽略的一点:Layui 的内部状态(包括 LAY_CHECKED 字段、全选统计、父子联动)对 disabled 完全无感。所有涉及“已选中”的逻辑——无论是取 ID 列表、判断全选、还是做批量提交——都得自己补一层数据过滤,没有例外。

别指望 checkRender(仅 ≥2.8.0 支持)能帮你省事,它的返回值不参与 table.checkStatus() 识别;也别用 pointer-events: none 代替 disabled,键盘 Space 仍能切换,且无障碍支持失效。

相关文章

精彩推荐