拖放
規則
- 使用
@dnd-kit/core + @dnd-kit/sortable — 現代、可無障礙存取、支援觸控的拖放函式庫
- 可排序列表:包裹在
<SortableContext> 中,每個項目使用 useSortable() 鉤子
- 看板:使用
<DndContext> 搭配多個 <SortableContext> 容器 — 每個欄位一個
- 檔案拖放區域:使用
react-dropzone 或原生的 onDragOver/onDrop 搭配 e.dataTransfer.files
- 觸控支援:dnd-kit 原生處理觸控 — 使用
TouchSensor 和 PointerSensor 並設定啟用條件
- 無障礙功能:dnd-kit 開箱即用提供鍵盤拖放 — 使用
KeyboardSensor 搭配 sortableKeyboardCoordinates
- 樂觀重新排序:放下時立即更新狀態,背景同步至伺服器,出錯時回滾
- 拖動疊加層:使用
<DragOverlay> 提供拖動項目的浮動預覽 — 更好的視覺回饋
範例
import { DndContext, closestCenter, DragOverlay } from "@dnd-kit/core";
import { SortableContext, verticalListSortingStrategy, useSortable } from "@dnd-kit/sortable";
import { CSS } from "@dnd-kit/utilities";
function SortableItem({ id, children }: { id: string; children: React.ReactNode }) {
const { attributes, listeners, setNodeRef, transform, transition } = useSortable({ id });
const style = { transform: CSS.Transform.toString(transform), transition };
return (
<div ref={setNodeRef} style={style} {...attributes} {...listeners}>
{children}
</div>
);
}
function SortableList({ items }: { items: Item[] }) {
const [activeId, setActiveId] = useState<string | null>(null);
return (
<DndContext
collisionDetection={closestCenter}
onDragStart={({ active }) => setActiveId(active.id)}
onDragEnd={handleDragEnd}
>
<SortableContext items={items.map((i) => i.id)} strategy={verticalListSortingStrategy}>
{items.map((item) => (
<SortableItem key={item.id} id={item.id}>{item.name}</SortableItem>
))}
</SortableContext>
<DragOverlay>{activeId ? <ItemPreview id={activeId} /> : null}</DragOverlay>
</DndContext>
);
}
避免
- 直接使用 HTML5 拖放 API — 觸控/行動/無障礙支援不佳
- 忘記鍵盤無障礙功能 — 務必加入
KeyboardSensor
- 在拖動過程中變更狀態 — 僅在
onDragEnd 時更新
- 缺少
DragOverlay — 沒有它,原始項目在拖動時會消失,失去視覺回饋