こんにちは、エンジニアのオオバです。

お悩みさん
お悩みさん
  • 列もカードと同じようにドラッグで並べ替えたい
  • DndContextを入れ子にしていいのか分からない
  • 列とカードで動きを分けたい
  • オオバ
    オオバ
    本記事ではこれらの悩みを解決します。

    自作のタスク管理ツールのカンバンで、カードを列の間で動かすところまでは作れていました。

    ただ、ステータスの列そのものも左右に並べ替えたくなりました。

    カードは縦、列は横。同じ画面で両方を掴めるようにしたいわけです。

    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つです。

    IDの接頭辞で行き先を分ける

    ドラッグの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箇所にまとめたことが、この実装の要点です。

    並び順を中間値で持つと、並べ替えの処理を共通化しやすくなります。

    自分のツールで同じ形のカンバンを作る方の参考になれば。

    関連記事

    オススメ記事
    検証環境