こんにちは、エンジニアのオオバです。
自作のタスク管理ツールのカンバンで、カードを列の間で動かすところまでは作れていました。
ただ、ステータスの列そのものも左右に並べ替えたくなりました。
カードは縦、列は横。同じ画面で両方を掴めるようにしたいわけです。
DndContextは1つにして、IDの接頭辞で列の並び替えかカード移動かを分けた
先に結論を書きます。
dnd-kit の DndContext を入れ子にすると、内側がドラッグのイベントを取ってしまいます。
そこで1つの DndContext の中に、列用の SortableContext(横方向)と、列ごとのカード用の SortableContext(縦方向)を同居させました。
IDには接頭辞を付けて、列の並び替えかカード移動かを判定しています。
ということで本記事では、この作りと並び順の持ち方をお届けします。
→11万文字で徹底解説した「DOTweenの教科書」Unityアニメーションの超効率化ツールはこちら
やりたかったこと:列とカードを同じ画面で動かす
カンバンは、列(ステータス)が横に並び、その中にカード(タスク)が縦に並ぶ形です。
この記事のキャプチャは、記事の作りだけを抜き出した最小の再現(React 18・@dnd-kit/core 6.3・@dnd-kit/sortable 10、データはサンプル)で撮っています。列の右上は列のドラッグID、カードの下はタスクIDと position です。

カードは列の間をドラッグで移動できていました。
列も動かすなら、列を並び替えるための SortableContext が必要になります。
問題は、カード用と列用の2つの SortableContext をどう組み合わせるかです。
やったこと:DndContextを1つにまとめる
DndContext を列ごとに作ると、内側が先にイベントを受け取ります。
そのため、1つの DndContext にまとめる形にしました。
中身は次の2つです。
- 列の SortableContext(横方向)
- 列ごとのカードの SortableContext(縦方向)
IDの接頭辞で行き先を分ける
ドラッグのIDは、種類ごとに接頭辞を変えました。
- 列の並び替え:
sort:<statusId> - 列のドロップ先:
col:<statusId> - カード: タスクIDのまま
onDragEnd では、active.id が sort: で始まれば列の並び替え、それ以外はカードの移動として扱います。
この判定は onDragEnd の1箇所だけで済みます。
つまり、IDの形を見れば何を動かしたかが分かるということ。
行き先の列は1つの関数で引く
over には、カード・列のドロップ先・列そのものの、どれが入るか決まっていません。
そこで、どの場合でも statusId を引ける columnOf() という関数にまとめました。
カードを移す先の列は、この関数の戻り値で決まります。
列を掴んでいる間はハイライトを止める
カードを移動している間は、onDragOver で乗っている列をハイライトします。

列を掴んでいる間は、このハイライトを止めました。
DragOverlay は列全体ではなく、列の見出しだけのゴーストにしています。

離すと列が入れ替わります。列のIDは sort:done のまま、並び順だけが変わります。

見出しを掴めるのに、クリックで改名もできる
列の見出し全体をドラッグの掴み場所にしました。
ただ、見出しはクリックすると名前を変えられる作りです。
そこで PointerSensor の activationConstraint に distance: 5 を指定し、動かした距離が5以上になったときだけドラッグを始めるようにしました。
これで、掴むのとクリックで改名するのが両立しました。
👉 Lucidchart風の図解ツールを自作した:AIがJSONを書けば図になり、CLIでPNGまで出る
ドラッグ中の状態を扱って詰まった話は、図解ツールの記事にも書いています。
並び順は position で持つ
並び順は position(REAL型)で保存しています。
並べ替えたら arrayMove のあと、動かした項目の前後の値の中間を入れます。
中間値を入れるので、並べ替えのたびに全件の番号を振り直さずに済みます。
この計算は movedPosition() にまとめました。
リストの項目・選択肢・担当者・プロジェクト・保存ビューの並び替えでも、同じ関数を使っています。
まとめ
入れ子のDndContextを避けたことと、IDの接頭辞で判定を1箇所にまとめたことが、この実装の要点です。
並び順を中間値で持つと、並べ替えの処理を共通化しやすくなります。
自分のツールで同じ形のカンバンを作る方の参考になれば。
関連記事

この記事が気に入ったらフォローしよう
- React 18
- @dnd-kit/core 6
- @dnd-kit/sortable 10








