Layui表格排序(sort)怎么实现服务器端排序

小萱小哥_9930

小萱小哥_9930

2026-05-07

1018人浏览

原创

layui table 实现服务端排序需拦截sort事件,提取field和order参数,通过table.reload()重新请求并传入where、initsort及page等配置,后端须白名单校验字段并安全拼接order by。

layui table 的 sort 事件默认只触发前端排序

点击表头触发 sort 事件时,layui 默认会尝试对当前已渲染的数据做前端重排——这和服务器端排序完全无关。如果你的数据是通过 url 异步加载的,不手动干预,sort 就只是个“假动作”,页面看似响应了点击,但数据没变,排序也没生效。

真正实现服务端排序,核心是:拦截 sort 事件 → 提取排序字段和方向 → 重新发起带参数的请求。

常见错误现象:table.render() 后点击表头无反应、控制台没发新请求、返回数据仍是未排序的原始结果。

  • 必须给 table 配置 id(如 id: 'userTable'),否则无法用 table.reload()
  • sort 事件回调里不能直接调用 table.render(),会销毁实例;要用 table.reload()
  • 后端接口需能接收类似 field=age&order=desc 这样的参数,并据此 SQL 加 ORDER BY

在 sort 回调中用 table.reload() 携带排序参数

监听 sort 事件后,把 field 和 order 作为额外参数传给 reload,触发新请求。注意:reload 不会重载全部配置,只合并传入字段,所以 url、page、where 等需显式保留或补充。

table.on('sort(userTable)', function(obj){
  table.reload('userTable', {
    initSort: obj, // 记录当前排序状态,让表头显示小箭头
    where: {
      field: obj.field,
      order: obj.type  // obj.type 是 'asc' 或 'desc'
    },
    page: { curr: 1 } // 排序后一般重置到第 1 页
  });
});

关键点:

  • initSort 必须传 obj,否则表头图标不更新
  • where 是发送给后端的实际查询参数,名字要和后端约定一致(比如有的后端用 sortField/sortOrder)
  • 如果表格启用了分页,page: { curr: 1 } 很重要,否则可能还在看第 5 页的“已排序”错觉数据

后端接收参数并生成 ORDER BY 的典型处理

服务端拿到 field 和 order 后,不能直接拼进 SQL——这是严重注入风险。必须白名单校验字段名,并限定 order 只能是 asc 或 desc。

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

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

下载

例如 Node.js + MySQL 示例:

const validFields = ['username', 'age', 'create_time'];
const field = validFields.includes(req.query.field) ? req.query.field : 'id';
const order = ['asc', 'desc'].includes(req.query.order) ? req.query.order : 'asc';
<p>const sql = <code>SELECT * FROM users ORDER BY ?? ?</code>;
// 使用 ?? 占位符防注入,? 不适用在 ORDER BY 中
connection.query(sql, [field, order], callback);</p>

Java(MyBatis)或 Python(SQLAlchemy)同理:字段名走白名单 + 枚举判断,值用参数化占位符。

  • 严禁用字符串拼接 ORDER BY ${field} ${order}
  • 如果后端框架不支持动态字段占位(如某些 ORM),就老实用 if/else 显式分支
  • 注意大小写和下划线命名是否匹配数据库列名,比如前端传 createTime,后端可能得映射为 create_time

容易被忽略的兼容细节

有些场景下,排序行为会意外失效,问题往往藏在配置细节里:

  • 表格初始化时没设 id,导致 table.reload('xxx') 找不到实例,静默失败
  • url 配置的是相对路径(如 '/api/list'),而 reload 时没重传 url,可能被覆盖成默认空值
  • 开启了 autoSort: false 却忘了在 reload 中也带上它(虽然默认就是 false)
  • 后端返回数据结构不符合 layui 要求(比如没包在 data 字段里,或没返回 count),导致 reload 后表格空白,误以为排序失败

最常漏掉的是:没在 reload 中显式传 url 和 cols ——它们不会自动继承,只靠 id 是不够的。

相关文章

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

5303

6

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

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

2024.03.19

6350

13

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

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

2024.03.22

5938

10

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

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

2024.05.22

843

5

服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

437

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

920

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2912

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

976

5

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习