Layui表格怎么在右侧工具栏中添加一个刷新按钮

雨敏小哥_3781

雨敏小哥_3781

2026-04-28

1064人浏览

原创

layui table的toolbar需手动配置按钮并监听tool事件,用table.on('toolbar(filter)', callback)捕获lay-event,调table.reload()时传入obj.config.page.curr、where及initSort等保持状态。

layui table 的 toolbar 属性怎么配刷新按钮

直接在 table.render() 的配置里加 toolbar,值设为一个带按钮的字符串或 dom 节点即可。layui 不会自动绑定点击事件,刷新逻辑得自己写——这点最容易漏掉,结果按钮点了没反应。

常见错误现象:toolbar: '#refreshBtn' 但页面里没定义该 ID 元素;或者写了 toolbar: '<button class="layui-btn">刷新</button>' 却没监听 tool 事件。

  • 推荐用字符串模板,简洁可控:toolbar: '<div class="layui-btn-container"><button class="layui-btn layui-btn-primary layui-btn-sm" lay-event="refresh">↻ 刷新</button></div>'
  • lay-event 的值(这里是 refresh)必须和后续监听的事件名一致
  • 如果用 DOM 节点,确保该节点在 table.render() 执行前已存在于页面中,否则渲染失败

如何监听 toolbar 按钮点击并触发表格重载

必须通过 table.on('toolbar(filter)', callback) 监听,而不是给按钮写 onclick——因为 Layui 表格是动态渲染的,原生绑定会失效。

使用场景:点击刷新时,一般要保留当前页码、搜索条件、排序状态。直接调 table.reload() 最稳妥,别手动改 page.curr 或拼 URL。

  • 监听示例:
    table.on('toolbar(test)', function(obj){<br>  if(obj.event === 'refresh'){<br>    table.reload('test', {<br>      page: {curr: obj.config.page.curr}, // 保持当前页<br>      where: obj.config.where // 保持搜索参数<br>    });<br>  }<br>});
  • obj.config 是原始 render 配置的副本,里面存着当前分页、where 参数等关键信息,比手动维护变量更可靠
  • 别漏掉 obj.config.where,否则刷新后搜索条件丢了

刷新按钮图标不显示或样式错乱怎么办

Layui 默认不加载图标字体,↻ 这种 Unicode 符号虽能用,但部分系统/浏览器渲染模糊;想用 <i class="layui-icon"></i> 就必须确保页面已引入 Layui 的 CSS 和字体文件。

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

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

下载

性能影响不大,但兼容性容易出问题:老版本 IE 不支持某些 Unicode,而 layui-icon 类依赖 CSS 字体声明。

  • 检查是否漏引 layui.css,尤其用模块化方式加载时,layui.use(['table', 'icon']) 并不能自动加载图标 CSS
  • 如果只想要简洁刷新效果,用 ↻(↻)比依赖字体更稳,代码里写成 ↻
  • 按钮加 layui-btn-sm 控制尺寸,避免和表头高度不匹配

为什么 reload 后排序/筛选状态丢失了

因为 table.reload() 默认不会继承原实例的排序字段和顺序,除非显式传进去。这是最常被忽略的一环——看着刷新了,点过排序的列又回默认状态。

可结合 obj.config.sort 和 obj.config.order 拿到当前排序信息,再透传给 reload。

  • 完整保态刷新示例:
    table.reload('test', {<br>  page: {curr: obj.config.page.curr},<br>  where: obj.config.where,<br>  initSort: {<br>    field: obj.config.sort,<br>    type: obj.config.order<br>  }<br>});
  • initSort 是 reload 的关键参数,不是 sort,拼错就无效
  • 如果表格启用了多列排序(multiSort: true),obj.config.sort 是数组,需额外处理
复杂点在于状态要从 obj.config 里“抠”出来再塞回去,而不是靠记忆或全局变量。少写一行 initSort,用户就会觉得刷新功能不完整。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

2760

4

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

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

2023.08.31

360

5

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

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

2023.11.15

2593

5

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

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

2024.09.24

1141

6

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

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

2026.10.10

100

15

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

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

2026.10.10

40

15

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

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

2026.10.10

20

15

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

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

2026.10.10

40

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

40

32

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Pandas 官方文档与用户指南
Pandas 官方文档与用户指南

共0课时 | 0人学习