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

Layui如何实现表格行数据的上下拖拽移动排序功能

陌磊同学_4046

陌磊同学_4046

发布时间:2026-05-10 08:08:00

|

997人浏览过

|

来源于php中文网

原创

layui table 默认不支持行拖拽排序,因其仅负责渲染和事件绑定,拖拽需手动集成原生 drag API 或第三方库;关键步骤包括设置 draggable、监听 dragstart/drop、更新 table.cache 并 reload。

layui如何实现表格行数据的上下拖拽移动排序功能

layui table 行拖拽排序为什么默认不支持

因为 layui 的 table 模块本身没内置拖拽逻辑,它只负责渲染和事件绑定,拖拽属于 DOM 层交互,得自己补。官方 demo 里所有“拖拽排序”都是基于原生 dragstart/dragover 或第三方库(如 sortablejs)手动集成的,不是调个参数就能开。

用原生 drag API 实现行拖拽的最小可行步骤

不用引入额外库,靠浏览器原生拖拽事件就能跑通,但要注意几个关键钩子和数据同步时机:

  • 给每行 <tr> 加 draggable="true",并监听 dragstart 记录被拖行的 data-index(即 layui 渲染时给的索引)
  • 在 dragover 阻止默认行为,否则拖入表格区域会触发浏览器默认跳转
  • 在 drop 里拿到目标行的 data-index,调用 table.cache["id"] 获取当前缓存数据,手动调整数组顺序
  • 必须调用 table.reload() 或 table.reloadData()(v2.8+)刷新视图,仅改缓存数组不会重绘

示例关键片段:

<tr data-index="2" draggable="true">...</tr>
<tr data-index="5" draggable="true">...</tr>

拖到第 5 行上松手后,要把原索引 2 的数据插到索引 5 前面,再 reload。

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

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

下载

拖拽后数据错位或顺序回滚的常见原因

reload 后恢复原始顺序?大概率是没正确更新 table.cache,或者 reload 时传了错误的 data 参数覆盖了你刚改好的缓存:

  • table.reload("id", { data: [...] }) 会完全忽略 cache,直接用你传的数组——这等于放弃你前面的手动调整
  • 正确的做法是:只改 table.cache["id"] 数组,然后调 table.reload("id", { done: () => {} }),不传 data
  • 如果用了分页,table.cache 只存当前页数据,跨页拖拽会失效;得先用 table.getData() 拿全量,操作完再整表 reload
  • 注意 data-index 是渲染序号,不是原始数据 id;拖拽前最好在原始数据里加个唯一 id 字段,避免多页/搜索后索引错乱

要不要用 sortablejs 替代原生 drag

可以,但别无脑套。sortablejs 对 <tbody> 的支持不稳,容易和 layui 的内部 tr 重绘冲突:

  • 必须等 table.render() 完成、DOM 真实渲染后再初始化 Sortable,不能写在 render 回调外
  • 要禁用 ghostClass 和 chosenClass,否则拖拽时样式错乱,layui 的 hover 效果会打架
  • 启用 forceFallback: true 能绕过部分移动端兼容问题,但 iOS Safari 上仍可能卡顿
  • 最省事的折中方案:只对单页表格用原生 drag,带分页/筛选的场景改用「点击上下箭头」+ 后端排序,更稳

拖拽排序真正难的从来不是怎么拖,而是拖完之后怎么让数据、缓存、视图、分页状态全部对齐——这里漏一环,用户就感觉“拖了但没拖”。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

UP简历
UP简历 Hot

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

豆包大模型

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

DeepSeek

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

WorkBuddy

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

墨刀AI
墨刀AI Hot

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

相关专题

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

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

2463

2023.08.11

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

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

5323

2023.10.09

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

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

6370

2024.03.19

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

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

5958

2024.03.22

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

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

843

2024.05.22

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

4051

2023.10.23

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

6968

2024.03.06

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

814

2025.12.30

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习

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

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