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

layui数据表格怎么自定义行工具栏

云明君_2767

云明君_2767

发布时间:2026-09-06 06:43:22

|

961人浏览过

|

来源于php中文网

原创

行操作按钮必须配置在cols列中且type为'tool',监听用table.on('tool(filter)'),模板id需带#前缀,按钮须加layui-btn类,lay-event值仅支持字母数字下划线。

layui数据表格怎么自定义行工具栏

行工具栏必须用列配置的 toolbar 字段,不能写在表格级 toolbar 里

表格顶部的 toolbar 是全局操作(比如“导出全部”),而每行右侧的操作按钮——新增、编辑、删除这类——必须放在 cols 的某一列定义中,且该列类型为 type: 'tool' 或显式设置 toolbar 指向模板。写错位置,按钮压根不会渲染。

常见错误是把行操作按钮塞进表格配置的 toolbar: '#rowToolbar',结果页面上什么也不显示。Layui 不会识别这种用法,也不会报错,只会静默忽略。

  • toolbar 列必须和其它数据列同级,放在 cols[0] 数组里,例如:{field: 'id', title: 'ID'} 后面追加一行:{fixed: 'right', title: '操作', toolbar: '#rowBar'}
  • 模板 ID 必须带 # 前缀,且与 <script type="text/html" id="rowBar"> 中的 id 完全一致(大小写、连字符都不能错)
  • 该列不能设 field,否则会尝试从数据中取值,导致按钮区域空白或显示 undefined

table.on('tool(filter)') 才是监听行按钮的正确事件名

顶部工具栏监听用 toolbar,行工具栏监听必须用 tool —— 少个字母、拼错都不行。漏掉这个细节,点击按钮毫无反应,控制台也看不到任何提示。

回调函数里的 obj 参数结构完全不同:这里能直接拿到当前行完整数据 obj.data、所在行索引 obj.tr、以及触发事件名 obj.event(即按钮上的 lay-event 值)。

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

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

下载
  • 监听代码必须写成:table.on('tool(userTable)', function(obj){ ... }),其中 userTable 是表格的 lay-filter 值,不是 ID 或 class
  • obj.event 就是按钮的 lay-event 值,比如 <button lay-event="edit"> → obj.event === 'edit'
  • 不要试图在 tool 事件里调用 table.checkStatus(),它返回的是勾选行,不是当前行;当前行数据就在 obj.data 里

模板里按钮的 lay-event 值必须合法,且不能含空格或特殊符号

写成 lay-event="edit user" 或 lay-event="delete!",事件就永远无法触发。Layui 内部用它作字符串匹配,只接受纯字母、数字、下划线组成的合法标识符。

另外,图标类按钮(比如带 <i class="layui-icon"></i> 的)必须确保 layui.css 已加载、网络面板里 iconfont 文件状态是 200。图标不显示但按钮可点,大概率是字体资源加载失败,不是代码问题。

  • 推荐命名风格:lay-event="edit"、lay-event="del"、lay-event="view",简短清晰
  • 如果需要区分不同权限下的按钮,不要在模板里硬编码显隐逻辑,而应在 render 前根据权限动态生成整套 cols 配置
  • 避免在模板中使用 lay-if 做复杂判断,Layui 的模板编译能力有限,嵌套过深容易出错

行工具栏按钮没有默认样式,.layui-btn 类必须手动加

Layui 不会自动给行内按钮加样式。如果你只写 <button lay-event="edit">编辑</button>,它就是个裸露的原生按钮,既没边框也没背景色,看着像文本链接。

必须显式加上 class="layui-btn layui-btn-xs" 这类类名。常用组合:layui-btn-xs(超小)、layui-btn-primary(浅色)、layui-btn-warm(橙色),搭配图标时再加 layui-btn-icon。

  • 别依赖 CSS 选择器全局覆盖,比如 .layui-table-view .layui-btn,因为行工具栏可能被重载多次,样式容易错乱
  • 如果按钮文字太长撑开列宽,用 minWidth 给该列设最小宽度,或改用图标按钮节省空间
  • 多个按钮并排时,用 <div class="layui-btn-container"> 包裹,它会自动处理间距和换行
行工具栏真正的难点不在渲染,而在事件上下文切换——顶部按钮操作的是整个表格,行按钮操作的是单条记录,两者的数据来源、作用域、甚至监听事件名都完全不同。稍不注意就会把 toolbar 和 tool 混用,或者误以为 obj.data 在两种事件里结构一致。

热门AI工具

更多
WorkBuddy

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

豆包大模型

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

讯飞智作

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Atoms
Atoms Hot

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

相关专题

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

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

2283

2023.08.11

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

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

4903

2023.10.09

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

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

6010

2024.03.19

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

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

5498

2024.03.22

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

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

783

2024.05.22

ajax教程
ajax教程

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

2560

2023.06.14

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

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

340

2023.08.31

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

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

2393

2023.11.15

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

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

精品课程

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

共87课时 | 12.7万人学习

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

共89课时 | 10.9万人学习

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

共5课时 | 1.6万人学习

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

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