layui 2.8 中需用 type: 'radio' 列配合 row-radio 事件手动管理单选状态,清除旧高亮、添加新高亮,并维护 selectedrow 变量获取数据,不可依赖 checkstatus。

如何用 layTable 的 radio 类型实现单选行
Layui 2.8 默认不提供“单选行”开关,但可通过列类型 type: 'radio' 配合 event 监听和手动样式控制达成真实单选效果。关键不是靠表格自身状态,而是靠监听点击、清除旧选中、高亮当前行。
必须注意:type: 'radio' 列本身只渲染一个 radio input,它不会自动绑定行级选中态,也不影响 checkStatus 方法——所以不能依赖 table.checkStatus 获取单选结果,得自己维护 selectedRow 变量。
- 在
cols中定义一列:{type: 'radio', unresize: true, width: 50} - 给该列加
event: 'row-radio',并在table.on('row-radio(...)中处理逻辑 - 每次点击时,先移除上一行的
layui-table-hover类(或自定义的selected类),再给当前行tr添加 - radio 列的
width建议固定(如50),避免因内容撑开导致错位
为什么不能直接用 checkbox + limit: 1
checkbox 模式下设 limit: 1 只限制勾选数量,但 UI 上仍是多选样式(带方框),用户可反复点击取消再选,不符合“单选按钮”的交互直觉;更重要的是,它无法阻止用户通过 Ctrl+Click 多选(浏览器原生行为),而 radio 是语义级单选,天然防多选。
另外,limit: 1 对 type: 'checkbox' 生效的前提是开启了 showCheck(即显示复选框列),但它仍会把表格变成多选模式,checkStatus 返回数组,跟单选语义冲突。
-
type: 'checkbox'+limit: 1是“强制最多选一个”,不是“只能单选” - radio 列不参与
checkStatus,避免数据混淆 - 若后端只要一个 ID,用 radio 更干净,不用过滤
data.length === 1的数组
如何获取当前单选的行数据
不要调用 table.checkStatus,它对 radio 列无返回。应在 row-radio 事件回调里直接取 obj.data,并缓存到变量中:
let selectedRow = null;
table.on('row-radio(test)', function(obj){
// 清除之前高亮
if (selectedRow && selectedRow.tr) {
selectedRow.tr.removeClass('layui-table-hover');
}
// 高亮当前行
obj.tr.addClass('layui-table-hover');
selectedRow = obj;
});
后续需要提交时,直接用 selectedRow?.data 即可。注意 obj.tr 是 jQuery 对象,removeClass/addClass 是 jQuery 方法,确保 Layui 加载顺序在 jQuery 之后。
- 别在事件外直接读
obj,它是局部变量 - 如果表格启用了分页,切换页码后
selectedRow不会自动清空,需自行判断是否仍在当前页 - 若需支持“点击已选行取消选择”,可在事件里加
if (selectedRow?.data.id === obj.data.id)分支处理
兼容性与容易被忽略的细节
Layui 2.8 的 radio 列在 IE11 下可能不触发 row-radio 事件(因事件委托失效),建议加一层 tr 级 click 监听兜底;另外,开启 height 启用滚动时,tr 的 addClass 可能因虚拟滚动失效——此时应改用 CSS 属性选择器高亮,例如为 radio input 添加 checked 后,用 td[data-field="x"] input[type=radio]:checked ~ tr(不推荐,复杂且不可靠),更稳的方式是监听 done 回调重刷高亮。
- 禁用表格排序时,排序图标会遮挡 radio,可在 CSS 中加
.layui-table-cell .layui-table-sort{display:none;} - 使用
skin: 'line'或'nob'时,hover 样式需同步覆盖对应 skin 的 class - 如果表格有
loading: true,首次加载完成前点击 radio 会无效,需等done后再绑定事件或用事件代理











