讲师中心 微信公众号
AI工具推荐 视频效率加速

Layui表格如何设置复选框只能单选

胖墨大大_8783

胖墨大大_8783

发布时间:2026-06-24 14:22:08

|

770人浏览过

|

来源于php中文网

原创

layui table单选应优先用type: 'radio',需确保每行有唯一id;若强制用checkbox模拟单选,须监听checkbox事件,清空其他行LAY_CHECKED并调用setRowChecked或reload同步视图。

layui table 复选框默认是多选,怎么改成单选

layui 的 table.render() 默认开启复选框列(type: 'checkbox')时,行为是多选 —— 这不是 bug,是设计如此。要实现“单选”,本质是**禁用多选逻辑,手动接管点击行为,确保同一时间最多一个 checked 状态**。

用 type: 'radio' 替代 type: 'checkbox' 最简单

layui 从 2.8.0 开始原生支持 type: 'radio',它会渲染为单选按钮,自动处理互斥逻辑,无需额外监听或干预。

  • 仅适用于「整行单选」场景,不支持跨页记忆(每页独立)
  • 必须配合 id 字段(用于唯一标识行),否则 radio 无法分组,会全部可选
  • 如果数据没带 id,得在 cols 中用 templet 手动写 <input type="radio">,但失去 layui 内置的事件绑定和样式统一
table.render({
  elem: '#demo',
  cols: [[
    {type: 'radio', width: 40}, // 关键:这里改用 radio
    {field: 'name', title: '姓名'}
  ]],
  data: [
    {id: '1', name: '张三'},
    {id: '2', name: '李四'}
  ]
});

不用 radio 时,如何用 checkbox 模拟单选

当 UI 规范强制要求显示为复选框图标(✓),但逻辑要单选,就得拦截默认行为。核心是:点击任意 checkbox 时,先清空所有已选,再勾选当前行。

  • 必须监听 table.on('checkbox(test)') 事件,不能只靠 click 绑定 —— layui 的 checkbox 是动态生成的
  • 事件回调里调用 table.checkStatus('test') 获取当前状态,再用 table.cache['test'] 遍历所有行并重置 LAY_CHECKED 属性
  • 别忘了调用 table.reload() 或手动触发 table.setRowChecked()(v2.9+)来同步视图,否则界面不更新
  • 注意分页:跨页单选需自己维护全局选中 ID,table.cache 只存当前页数据

为什么不要直接操作 DOM 的 checked 属性

layui 的 checkbox 状态不完全依赖原生 DOM 的 checked,它还依赖行数据对象上的 LAY_CHECKED 标记和内部索引。直接改 DOM:

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

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

下载
  • 会导致 table.checkStatus() 返回结果与界面不一致
  • 翻页后状态丢失(因为没同步到数据源)
  • 全选/反选功能失效(它们依赖 LAY_CHECKED)
  • 在 IE 或低版本浏览器中可能触发重复渲染或卡顿

真正可靠的路径只有两条:用 type: 'radio',或者用 layui 提供的 API(setRowChecked / reload + 数据层更新)做状态同步。

单选这事看着小,但混用 DOM 操作和 layui 数据流是最容易埋坑的地方 —— 表面能点,一翻页、一搜索、一 reload 就露馅。

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

2383

2023.08.11

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

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

5163

2023.10.09

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

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

6230

2024.03.19

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

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

5778

2024.03.22

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

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

823

2024.05.22

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

0

2026.10.10

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

0

2026.10.10

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

20

2026.10.10

热门下载

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

精品课程

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

共87课时 | 12.8万人学习

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

共89课时 | 11万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn