Layui上传组件如何实现在列表模式下拖拽调整顺序

夜瑶酱_6722

夜瑶酱_6722

2026-07-14

338人浏览

原创

layui upload 不支持拖拽排序,因其仅负责文件选择、上传和回调,不维护dom顺序或提供拖拽事件;必须用sortable.js接管预览容器,并同步更新文件数组、表单字段(如fileorder)及后端逻辑。

不能靠 upload.render() 配置里的 multiple: true 实现拖拽排序——它只控制多选,不管理上传后 dom 的顺序。

为什么 upload 自身不支持拖拽排序

Layui upload 模块的职责非常明确:监听选择、发请求、回调 done,然后把结果 append 到你指定的容器(比如 layui-upload-list)里。它不维护 DOM 顺序,也不暴露拖拽相关事件(如 onDragStart)。你看到的预览列表只是静态 <img> 或 <div class="layui-upload-file">,没有交互能力。 <ul> <li>给 <code><img> 加 draggable="true" 会触发浏览器默认文件拖出行为,不是列表内重排

  • dragstart/dragover/drop 手动监听要算插入位置、处理边界、防重复,极易出错且移动端完全失效
  • 上传过程中若混入 loading 占位图,原生 drag 会把它一起拖,状态混乱
  • 必须用 Sortable.js 接管预览容器

    这是当前最稳定、兼容性最好、Layui 项目中落地最多的方案。关键不是“能不能”,而是“怎么接得不打架”:

    • 初始化时机必须在 done 回调执行完、DOM 真实插入后,否则 Sortable 找不到目标元素
    • el 必须指向 layui-upload-list 的父容器(通常是 <div class="layui-upload-list">),不能是里面某个 <code><img>
    • 加 animation: 150 让拖拽有视觉反馈,避免用户觉得卡顿
    • 移动端必须设 forceFallback: true,否则 iOS Safari 静默失败(它不触发 dragstart)
    • 在 onEnd 里用 evt.oldIndex 和 evt.newIndex 调整你维护的文件数组(如 uploadedFiles = [])
    • 别忘了同步更新表单字段和后端接收逻辑

      拖拽只改了 DOM 顺序,但提交时后端仍按原始顺序处理——除非你显式传新顺序:

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

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

      下载
      • 把新顺序存回隐藏域,例如:<input name="fileOrder" value="3,1,4,2">
      • 后端必须依赖这个 fileOrder 字段做索引重排,不能只按 request.files 的接收顺序处理
      • 如果上传列表里有删除按钮,删掉某项后要重新生成 fileOrder 值,避免索引断层
      • 预览容器的 CSS 需补 position: relative,否则 ghostClass 绝对定位会错位

      真正麻烦的不是拖拽本身,而是 DOM、内存数组、表单字段三者状态不同步——拖完没更新 fileOrder,或者后端忽略该字段,就等于白做。

    相关文章

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

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

    下载

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

    相关专题

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

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

    2023.10.23

    3771

    6

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

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

    2024.03.06

    6348

    6

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

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

    2025.12.30

    774

    19

    html5新老标签汇总
    html5新老标签汇总

    HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

    2025.12.30

    674

    12

    html5空格代码怎么写
    html5空格代码怎么写

    在HTML5中,空格不能直接通过键盘空格键实现,需使用特定代码。本合集详解常用空格写法:&nbsp;(不间断空格)、&ensp;(半个中文空格)、&emsp;(一个中文空格)及CSS的white-space属性等方法,帮助开发者精准控制页面排版,避免因空格失效导致布局错乱,适用于新手入门与实战参考。

    2025.12.30

    353

    8

    html5怎么做网站教程
    html5怎么做网站教程

    想从零开始学做网站?这份《HTML5怎么做网站教程》合集专为新手打造!涵盖HTML5基础语法、页面结构搭建、表单与多媒体嵌入、响应式布局及与CSS3/JavaScript协同开发等核心内容。无需编程基础,手把手教你用纯HTML5创建美观、兼容、移动端友好的现代网页。附实战案例+代码模板,快速上手,轻松迈出Web开发第一步!

    2025.12.31

    501

    12

    HTML5建模教程
    HTML5建模教程

    想快速掌握HTML5模板搭建?本合集汇集实用HTML5建模教程,从零基础入门到实战开发全覆盖!内容涵盖响应式布局、语义化标签、Canvas绘图、表单验证及移动端适配等核心技能,提供可直接复用的模板结构与代码示例。无需复杂配置,助你高效构建现代网页,轻松上手前端开发!

    2025.12.31

    318

    7

    html5怎么使用
    html5怎么使用

    想快速上手HTML5开发?本合集为你整理最实用的HTML5使用指南!涵盖HTML5基础语法、主流框架(如Bootstrap、Vue、React)集成方法,以及无需安装、直接在线编辑运行的平台推荐(如CodePen、JSFiddle)。无论你是新手还是进阶开发者,都能轻松掌握HTML5网页制作、响应式布局与交互功能开发,零配置开启高效前端编程之旅!

    2025.12.31

    561

    20

    html5怎么播放视频
    html5怎么播放视频

    想让网页流畅播放视频?本合集详解HTML5视频播放核心方法!涵盖<video>标签基础用法、多格式兼容(MP4/WebM/OGV)、自定义播放控件、响应式适配及常见浏览器兼容问题解决方案。无需插件,纯前端实现高清视频嵌入,助你快速打造现代化网页视频体验。

    2025.12.31

    498

    20

    热门下载

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

    精品课程

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

    共87课时 | 12.7万人学习

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

    共89课时 | 10.9万人学习

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

    共5课时 | 1.6万人学习