Layui 2.8版本如何实现表格的单选模式并获取选中行数据

老杰君_3673

老杰君_3673

2026-04-23

822人浏览

原创

需在cols中显式配置{type: 'radio', fixed: 'left'},name属性统一、value唯一且初始化即存在;默认选中靠数据字段驱动;获取选中行应使用table.on('radio')事件回调中的obj.data,避免checkStatus().data[0]时机错误。

怎么配出单选列,而不是复选框

必须在 cols 里显式声明 {type: 'radio', fixed: 'left'},不能只写 {type: 'checkbox'} 然后指望它变单选。layui 不会自动转换类型,type 值写错就根本不会渲染单选按钮。

常见错误是漏掉 fixed: 'left' —— 虽然不加也能显示,但点击时可能触发多次事件或状态错乱;加了能确保 radio 在左侧固定列,行为更稳定。

  • radio 列必须放在 cols 数组最前面(或至少是 fixed 列),否则样式和事件绑定容易异常
  • 别在 templet 里手动写 <input type="radio">,Layui 会接管并清空 checked 属性
  • 如果用了 toolbar,radio 列要避开 toolbar 操作区,否则点击工具栏按钮可能误触发单选

如何让某一行默认被选中

靠数据字段驱动,不是靠 API 调用。比如原始数据里有 {id: 101, name: "张三", is_selected: true},就在 radio 列的 templet 函数里判断:

{field: 'id', title: '操作', templet: function(d) {
  return '<input type="radio" name="selectRow" value="' + d.id + '" checked :>';
}}

注意三点:

  • name 属性必须一致(如 name="selectRow"),否则浏览器无法实现单选互斥
  • value 必须有且唯一,后续取值全靠它;没 value 就算点了也拿不到标识
  • 初始化前就得把 is_selected 字段塞进原始 data 或接口返回的数据里,渲染完再改没用

点击行时怎么同步选中对应 radio

启用 rowClickToCheck: true 是最简方案,但仅在配置了 type: 'radio' 的前提下生效。它本质是模拟点击该行 radio,所以必须确保 radio 列已存在且可交互。

如果需要自定义逻辑(比如禁用某些行的点击选中),就换监听 row(filter) 事件:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
table.on('row(test-table)', function(obj) {
  // 手动触发 radio 选中:先清空所有,再设当前行
  var cache = table.cache['test-table'];
  cache.forEach(function(row) { delete row.layuiTableRadioChecked; });
  obj.data.layuiTableRadioChecked = true;
  table.reload('test-table', { done: function() {
    // 重载后调用 checkStatus 才能拿到最新选中项
  }});
});

不过更推荐的做法是:直接用 table.checkStatus('test-table').data 取值,它天然只返回当前页唯一选中行(radio 模式下 data 数组长度最多为 1)。

获取选中行数据时最容易踩的坑

table.checkStatus('xxx').data 返回的是数组,即使只选了一行也是 [{...}],别直接当对象用。常见错误写法:checkStatus().data.id → 正确是 checkStatus().data[0].id。

另外要注意时机:

  • 表格还没渲染完就调 checkStatus(),返回空数组 —— 得等 done 回调之后再取
  • 用了分页,checkStatus() 只返回当前页的选中行,跨页不累计(Layui 设计如此,不是 bug)
  • 如果手动修改过 DOM 或缓存(比如直接改 table.cache),checkStatus() 不会自动感知,得 reload 或手动触发更新

真正稳定的取值时机,是在 table.on('radio(test-table)', ...) 事件回调里,此时 obj.data 就是刚被选中的那行完整数据,不用再查、不会错页、也不依赖渲染顺序。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2463

5

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

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

2023.10.09

5283

6

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

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

2024.03.19

6350

13

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

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

2024.03.22

5918

10

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

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

2024.05.22

843

5

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2780

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2613

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习