SvelteSortableJS多列表拖拽教程
时间:2026-01-26 11:45:42 347浏览 收藏
知识点掌握了,还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战,手把手教大家学习《Svelte SortableJS 多列表拖拽排序教程》,在实现功能的过程中也带大家重新温习相关知识点,温故而知新,回头看看说不定又有不一样的感悟!

本文详解如何在 Svelte 中结合 SortableJS 实现多个动态嵌套列表的稳定拖拽排序,重点解决因缺失 key、状态同步不一致导致的 UI 错乱、重复移动等问题,并提供基于 action 的简洁、可维护方案。
在 Svelte 中集成 SortableJS 处理多组动态列表(如分类看板)时,常见问题并非来自 SortableJS 本身,而是 Svelte 的响应式更新机制与 DOM 同步逻辑未对齐所致。最典型的症状包括:列表项“双倍移动”、拖拽后顺序回滚、跨列表拖入失败或 UI 滞后——这些几乎都指向两个核心缺陷:#each 缺失唯一 key 和 组件状态与顶层数据源双向绑定失控。
✅ 正确做法一:强制 #each 使用稳定 key
Svelte 的 #each 块默认使用数组索引作为隐式 key。当列表顺序变化(尤其跨列表拖拽)时,索引快速重排会导致 DOM 元素被错误复用或销毁,引发视觉抖动与状态错位。必须显式指定唯一、稳定、不可变的 key:
{#each category as item (item.id)}
<li data-id={item.id}>{item.name}</li>
{/each}(item.id) 是关键——它告诉 Svelte:“此
✅ 正确做法二:用 use: action 替代自定义组件封装
将 Sortable 初始化逻辑封装进独立组件(如 List.svelte)看似模块化,实则引入了额外的状态层(arr = fullArr[index])、生命周期耦合(onMount 时机)及响应式陷阱(直接赋值 fullArr[index] = ... 可能绕过 Svelte 的响应式追踪)。更优解是使用 Svelte Action —— 它天然绑定到 DOM 元素,生命周期清晰,且与顶层状态完全解耦:
<script>
import Sortable from 'sortablejs';
let items = [
[{id: 1, name: "one"}, {id: 2, name: "two"}],
[{id: 3, name: "three"}, {id: 4, name: "four"}]
];
function initSortable(node, listIndex) {
const sortable = new Sortable(node, {
group: 'list',
onEnd(event) {
// ✅ 精准操作:从原列表删除,插入目标列表指定位置
const fromIdx = Number(event.from.dataset.listIndex);
const toIdx = Number(event.to.dataset.listIndex);
const [moved] = items[fromIdx].splice(event.oldIndex, 1);
items[toIdx].splice(event.newIndex, 0, moved);
// ⚠️ 关键:触发响应式更新!
items = [...items];
}
});
return {
destroy() {
sortable.destroy();
}
};
}
</script>
{#each items as category, i}
<h2>Category {i}</h2>
<ul data-list-index={i} use:initSortable={i}>
{#each category as item (item.id)}
<li data-id={item.id}>{item.name}</li>
{/each}
</ul>
{/each}
<pre>{JSON.stringify(items, null, 2)}? 为什么 items = [...items] 不可省略?
items[fromIdx].splice(...) 和 items[toIdx].splice(...) 直接修改了嵌套数组的内部结构,但 Svelte 不会自动检测深层嵌套变更。重新赋值 items = [...items] 触发顶层引用变更,强制 Svelte 重新 diff 整个 items 结构,确保 UI 精确同步。
✅ 进阶建议:使用 onSort 还是 onEnd?
- onSort: 适合仅需单列表内排序,通过 sortable.toArray() 获取 ID 序列再映射回对象。但跨列表时需遍历 items.flat() 查找,性能略低且易受重复 ID 影响。
- onEnd: 推荐用于多列表场景。event.from/event.to 明确指示来源与目标容器,event.oldIndex/event.newIndex 提供精确位置,配合 .splice() 可实现原子级、零副作用的数据迁移,逻辑更清晰、性能更优。
? 总结:三大避坑原则
- 永远为 #each 显式声明 (key) —— 尤其涉及拖拽、增删、排序等 DOM 重排操作;
- 优先选用 use: action 而非自定义组件封装第三方库 —— 减少状态桥接、避免生命周期冲突;
- 深层嵌套数组变更后,必须触发顶层响应式更新 —— arr = [...arr] 或 arr = structuredClone(arr) 是安全写法。
遵循以上实践,即可构建出响应灵敏、行为确定、易于维护的 Svelte + SortableJS 多列表拖拽系统。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《SvelteSortableJS多列表拖拽教程》文章吧,也可关注golang学习网公众号了解相关技术文章。
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
279 收藏
-
144 收藏
-
242 收藏
-
433 收藏
-
482 收藏
-
484 收藏
-
475 收藏
-
201 收藏
-
235 收藏
-
476 收藏
-
185 收藏
-
459 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习