Layui表格如何实现列的拖拽调整顺序

落宇大大_2781

落宇大大_2781

2026-05-07

589人浏览

原创

layui table 列拖拽顺序调整原生不支持,需手动监听 mouse 事件并动态重绘表头,通过 table.reload() 传入新顺序 cols 实现,注意保留 page/where 等参数及 fixed 列特殊处理。

layui table 列拖拽顺序调整原生不支持

layui 2.8.x 及之前所有版本的 table.render() 都没有内置列拖拽排序功能,直接调用 table.init() 或设置 cols 数组顺序也不会在 ui 上响应拖拽行为。这不是配置遗漏,而是设计上未实现——官方文档和源码中均无 dragcol、coldraggable 等相关选项。

必须手动监听 mouse 事件 + 动态重绘表头

核心思路是:捕获表头 th 的 mousedown 和 mousemove,计算拖拽位移,临时插入占位 th,松开时调用 table.reload() 并传入新顺序的 cols 数组。注意以下关键点:

  • 需在 table.render() 的 done 回调里绑定事件(确保 DOM 已渲染)
  • 不能直接操作 thead DOM 后“保留状态”,因为 layui 表格每次 reload 都会完全重建整个表格结构
  • cols 是二维数组(如 [[{field:'id'}, {field:'name'}]]),调整顺序必须替换最内层数组元素位置
  • 务必禁用默认文本选中:document.onselectstart = () => false,否则拖拽时会触发文字高亮干扰

示例:交换两列位置后 reload

假设原始列定义为:

const cols = [[
  {field: 'id', title: 'ID'},
  {field: 'username', title: '用户名'},
  {field: 'email', title: '邮箱'}
]];

用户拖拽“邮箱”列到“ID”列前面,你需要生成新 cols:

const newCols = [[
  {field: 'email', title: '邮箱'},
  {field: 'id', title: 'ID'},
  {field: 'username', title: '用户名'}
]];

然后执行:

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

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

下载
table.reload('yourTableId', {
  cols: newCols,
  // 其他参数如 page、where 若有需一并传入,否则会重置分页/筛选
});

漏传 where 或 page 会导致当前筛选条件丢失或跳回第 1 页。

兼容性与性能隐患

拖拽过程中频繁 reload 会造成明显闪烁,且在数据量大(>1000 行)、列数多(>15 列)时卡顿显著。更稳妥的做法是:

  • 仅在 mouseup 后 reload 一次,而非实时跟随拖拽
  • 用 table.cache['yourTableId'] 缓存原始数据,避免 reload 时重复请求接口
  • 对固定列(fixed: 'left')单独处理逻辑,它们不在主 thead 流中,DOM 结构分离
  • 移动端无 mouse 事件,需额外补充 touchstart/touchmove,但 layui 表格本身对移动端支持有限,建议桌面端优先

真正稳定可用的列拖拽,往往要配合 layui.jquery 封装一个轻量级拖拽插件,监听 th 的位移并映射到 cols 索引变更——这个映射关系一旦出错,reload 后列内容和标题就对不上了,是最容易被忽略的断裂点。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

2026.10.14

0

15

二狗PPT文档转PPT全教程
二狗PPT文档转PPT全教程

本专题讲解二狗PPT解析Word、PDF、Excel和PPT资料的方法,涵盖文件上传、内容提取、大纲整理、异常处理与转换后校对。

2026.10.14

0

13

讯飞绘文全功能使用教程
讯飞绘文全功能使用教程

本专题系统整理讯飞绘文官网入口、注册登录、工作台及内容创作流程,帮助用户熟悉常用功能,快速完成首篇图文内容。

2026.10.14

0

14

讯飞绘文AI写作与文案生成合集
讯飞绘文AI写作与文案生成合集

本专题聚焦讯飞绘文AI写作、提纲生成、文章改写和文案润色,覆盖从主题输入到成稿优化的关键操作与实用技巧。

2026.10.14

0

14

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

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

2026.10.10

100

15

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习