Layui数据表格如何实现行内的Checkbox只读状态切换

幻夢星雲

幻夢星雲

2026-07-31

495人浏览

原创

Layui表格中直接设disabled属性无效,因其渲染后DOM被重写;必须在templet中同时添加disabled属性和lay-disabled类,并调用layui.form.render()同步UI状态。

为什么 checkbox 在 Layui 表格里设了 disabled 却没反应?

layuitable.render() 渲染后,单元格里的 checkbox 是由 layui 自动重写的 dom(转成带样式的小方块),直接给原始 input[type="checkbox"]disabled 属性或 js 控制 disabled,layui 不会同步更新它的 ui 状态,看起来“失效”了。

真正生效的方式是让 Layui 在渲染时就知道这个 checkbox 该禁用——靠列配置项 templet + 手动输出带 lay-disabled 类的 HTML,或者用 checked + disabled 同时写在 input 上,并确保 Layui 的复选框渲染逻辑能识别它。

  • 必须在列定义的 templet 中返回完整 HTML 字符串,不能只写 <input type="checkbox">
  • 禁用状态要同时满足:disabled 属性 + lay-disabled 类(Layui 2.8+ 推荐),否则 UI 不同步
  • 如果用了 checkCol(默认勾选列),它不支持动态只读,得换成自定义 templet

如何用 templet 实现某几行 checkbox 只读?

核心是:在 templet 函数里根据 d(当前行数据)判断是否只读,然后拼出对应 HTML。Layui 会原样插入并自动执行 form 渲染。

{
  title: '选择',
  type: 'checkbox',
  templet: function(d) {
    // 假设 d.status === 0 表示不可操作
    var disabled = d.status === 0 ? ' disabled lay-disabled' : '';
    return '<input type="checkbox" name="checkbox" lay-skin="primary" disabled>';
  }
}
  • lay-skin="primary" 是必须的,否则样式不生效
  • 不要漏掉 name 属性,否则 table.checkStatus() 拿不到该列值
  • 如果表格启用了 evenodd 隔行色,禁用 checkbox 的视觉反馈(灰色)依赖 lay-disabled 类,缺了就只是点不动,但颜色还是正常色

切换只读状态时,怎么让已渲染的 checkbox 实时更新?

表格渲染完成后,不能靠改 data 再调 table.reload() 来刷新单个 checkbox 状态——太重,且会丢失当前页码、排序等状态。

layui手机车牌号码键盘代码
layui手机车牌号码键盘代码

layui手机车牌号码键盘代码是一款基于jQuery跟layui制作的手机端车牌号码输入弹出键盘选择,支持新能源汽车车牌输入格式代码。

下载

更轻量的做法是:定位到对应行的 checkbox 元素,手动加/删属性和类,再触发一次 Layui 的表单重渲染。

// 假设要更新第 3 行(索引从 0 开始)、"选择"列的 checkbox
var tr = $('.layui-table-body tbody tr').eq(2);
var checkbox = tr.find('input[name="checkbox"]');
checkbox.prop('disabled', true).addClass('lay-disabled');
layui.form.render('checkbox', 'your-table-id');
  • layui.form.render('checkbox', 'your-table-id') 的第二个参数是表格容器的 id(不是 table 的 lay-filter),必须传,否则可能全局重渲染
  • 别用 checkbox.attr('disabled', 'disabled'),要用 prop,否则 jQuery 1.9+ 无法正确控制状态
  • 如果该行被分页隐藏了,tr.eq(2) 会找不到——得先用 table.cache['your-id'] 查数据,再通过 table.getCheckData() 或遍历 DOM 定位可见行

为什么用 table.on('checkbox') 监听时,只读 checkbox 还会触发事件?

这是 Layui 的一个常见误解:加了 disabled 的 checkbox,原生点击不会触发 change,但 Layui 的 checkbox 事件是绑定在父容器上的代理事件,它不管子元素是否 disabled,只要点击区域命中就会触发。

所以必须在监听回调里手动过滤:

table.on('checkbox(test)', function(obj){
  // 检查当前 checkbox 是否被禁用
  if ($(obj.elem).is(':disabled')) return;
  console.log('正常勾选:', obj);
});
  • 仅靠 obj.elem.disabled 不可靠,因为 DOM 属性可能未同步,用 jQuery 的 :disabled 伪类更稳
  • 别在 templet 里用 onclick="return false" 拦截,Layui 的事件机制会绕过它
  • 如果业务逻辑复杂(比如只读状态受多个字段影响),建议把判断逻辑抽成函数复用,避免重复写条件
实际用的时候,最易忽略的是 lay-disabled 类和 form.render 的容器 ID —— 少一个,UI 就卡在“能看不能判”的状态。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2262

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2132

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2322

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

336

5

Selenium WebDriver元素定位与页面操作教程
Selenium WebDriver元素定位与页面操作教程

本专题整理Selenium WebDriver元素定位、XPath、CSS Selector、等待机制、窗口切换、Frame处理、Alert弹窗、Cookie操作和文件上传等核心用法。

2026.08.05

0

26

Selenium Grid分布式测试与并行执行教程
Selenium Grid分布式测试与并行执行教程

本专题整理Selenium Grid架构、远程WebDriver、并行测试、Docker部署、Kubernetes动态Grid、浏览器矩阵和测试环境扩展方法,适合进阶自动化测试团队使用。

2026.08.05

0

18

Selenium常见报错排查与自动化测试稳定性
Selenium常见报错排查与自动化测试稳定性

本专题整理Selenium常见报错、驱动版本问题、元素找不到、点击失败、等待超时、浏览器闪退、脚本不稳定和测试用例维护方法。

2026.08.05

0

17

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

11

21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 11.4万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 9.7万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.5万人学习