拖拽卡片需设draggable="true"并配JS事件:dragstart中setData传ID,drop绑列容器且dragover调preventDefault;布局用flex非grid;dataTransfer只传字符串;移动端须touch降级。

拖拽卡片必须设 draggable="true",但光加属性没用
浏览器默认只允许拖图片、链接和可编辑文本,div 类卡片即使加了 draggable="true" 也不会触发 dragstart。常见错误是只写 HTML 属性,不配 JS 监听。
必须手动在卡片上绑定事件:
-
dragstart里调用event.dataTransfer.setData('text/plain', cardId),否则 drop 时取不到 ID -
dragover必须在目标列容器(不是卡片)上调用event.preventDefault(),否则鼠标显示“禁止”图标,drop根本不触发 - 别把
drop绑在.card上——拖到列空白处就失效;要绑在列容器(如.kanban-column)上
弹性占位靠 flex + min-width,别用 grid 做多列看板主结构
看板的三列(待办/进行中/已完成)本质是水平排列的固定宽度容器,每列内任务垂直堆叠。用 display: grid 控制列宽反而难适配动态内容:某列卡片太多时,grid 列宽被锁死,容易横向溢出或滚动。
更稳的做法:
- 外层容器设
display: flex; gap: 16px - 每列设
flex: 0 0 320px(不伸缩、最小宽 320px),小屏下自动换行靠flex-wrap: wrap - 列内卡片列表用
display: flex; flex-direction: column; gap: 8px,比margin-bottom更干净,无合并问题 - 卡片本身设
flex: 0 0 auto,防止被 flex 拉伸变形
跨列拖拽时,dataTransfer 只传轻量数据,别传 DOM 节点
很多人想在 dragstart 里存整个 card.cloneNode(true),这在 Safari 和旧 Edge 会失败,且移动端完全不支持。原生 dataTransfer 只能可靠传字符串。
正确做法是传结构化轻量信息:
event.dataTransfer.setData('text/plain', JSON.stringify({ id: 'task-42', fromColumn: 'todo' }))-
drop触发后,读目标列的dataset.column(比如)- 再调 API 更新后端状态,而不是直接移动 DOM —— 状态驱动渲染才可控,尤其有分页或筛选时
- 本地临时 UI 更新用
insertBefore或重渲染,但必须基于数组索引,而非依赖rowIndex/cellIndex(表格合并单元格时会崩)移动端必须降级,原生 drag API 在 iOS Safari 上基本不可用
iOS Safari 和多数安卓 WebView 完全忽略
draggable和drag事件。强行用会白屏或卡死,不是兼容性问题,是功能缺失。真实可用的 fallback 方案:
- 监听
touchstart记录起始坐标和卡片 ID,设全局变量draggingId = 'task-42' -
touchmove中用transform: translate(x, y)模拟拖拽跟随,禁用系统手势:touch-action: none -
touchend时用document.elementFromPoint(x, y)找到目标或列容器,再取其 dataset.column- 桌面端和移动端状态必须走同一套数据流(如 Redux 或 reactive state),否则拖完一个任务,另一端看不到变化
真正麻烦的不是拖拽动作本身,而是插入点判断精度、跨端状态同步时机、以及 Safari 对
dataTransfer.setDragImage()的弱支持——这些不真机反复测,上线后必然丢任务或错位。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











