javascript ドラッグ アンド ドロップ 並び替え 9種 — FLIPコピペ
javascript ドラッグ アンド ドロップ 並び替えは、掴んだ項目の中心の判定と移動距離の逆変換という二つの計算です。ドラッグ中の項目の中心が隣の中間点を越えた瞬間に残りの項目が押し出され、離した瞬間に移動距離を測って逆変換で巻き戻すFLIP計算が、並び替え全体をライブラリなしで動かす。
01 dsl-flip-vertical-list
02 dsl-swap-midpoint-threshold
03 dsl-flip-grid-columns
04 dsl-kanban-axis-flip
05 dsl-autoscroll-velocity-curve
06 dsl-handle-target-drag
07 dsl-order-persist-index
08 dsl-ghost-inertia-tilt
09 dsl-keyboard-step-reorder
- 01 移動距離を測って逆変換で巻き戻す基本縦FLIPリスト
- 02 中心が隣の中間点を越えた瞬間に場所を譲る閾値スワップ
- 03 行をまたぐ移動まで計算するグリッド2列FLIP
- 04 縦から横へ軸が切り替わるカンバンカラム移動
- 05 端からの距離を速度曲線に変えるオートスクロール
- 06 ハンドルを掴んだときだけドラッグされる指定
- 07 変わった順序をインデックスに直列化して保存する順序維持
- 08 ドラッグ速度がゴーストの傾きを変える慣性チルト
- 09 矢印キーで一つずつ動かすキーボード代替整列
ドラッグ並び替えの仕組み — 中間点の判定と距離の逆変換という二つの計算
この九つの場面を並べた順番は、計算が積み上がる向きです。01が並べ替えの前後で位置を測る基本のFLIPを敷き、02が入れ替わりが起きる瞬間を値で決め、03と04がその判定を2列グリッドとカンバンのカラムへ広げます。05はリストが画面より長くなるとき、06はドラッグの開始条件をハンドルへ絞るとき、07は変わった順序を次の訪問まで覚えるとき、08は操作感に慣性を足すとき、09はポインターなしで同じことをするとき、それぞれに要る計算一段です。
測り方と数値の性質
数値は 도구/demo.py が480×300の箱を24枚撮り、隣り合う二枚の差23個から出した実測で、測定時刻は2026-11-16 00:38〜00:39です。累積面積は最初の枚から変わった画素を含む枚の割合、強度はその色差の平均、動いたフレームは直前の枚と変わった枚数です。測定の場面の動きはすべて、決定的な座標とキー入力を注入する自動デモによるものです。
九つの場面の測定値
| 場面 | 累積面積 | 強度 | 動いたフレーム |
|---|---|---|---|
| 01 基本縦FLIP | 31.6% | 116.0 | 23/23 |
| 02 閾値スワップ | 14.6% | 118.4 | 23/23 |
| 03 グリッド2列 | 16.7% | 110.1 | 23/23 |
| 04 カンバン軸切り替え | 15.4% | 112.0 | 23/23 |
| 05 オートスクロール曲線 | 13.0% | 118.9 | 23/23 |
| 06 ハンドル専用 | 22.5% | 110.1 | 23/23 |
| 07 順序保存 | 21.6% | 112.5 | 23/23 |
| 08 ゴーストチルト | 28.6% | 107.2 | 23/23 |
| 09 キーボード代替 | 3.5% | 116.2 | 23/23 |
累積面積が最も広いのは01で、五行が一度に押されるからです。08はゴーストの傾きと影が速度に比例して動き続けるため28.6%、07は保存と復元のフェードで21.6%です。09が3.5%で最も小さいのは、一つ分の交換が静かに繰り返されるキーボードの場面だからで、画面が静かなぶん読み上げの文とフォーカスの移動がその席を埋めます。九つの場面はすべて23/23で、枠の中では毎フレーム何かが動いていました。
入れ替えはいつ起きるか — 中心点の通過判定が閾値で、その値が操作感を決める
手が動いているあいだ、ブラウザーは毎瞬ひとつだけ決めます — 掴んだカードの中心yはいま何番目のスロットにいるか。スロット番号は割り算ひとつで出ます。掴んだカードの中心yをスロットの高さで割ると小数の付いた番号が出ます — 1.4スロット目、1.6スロット目という具合です。この小数を丸めて目標スロットを決め、いまのスロットと違えば配列を splice で入れ替えます。ここで閾値が出ます。元のスロットとの距離が0.5スロットを越えたら変えるか、0.85スロットを越えたら変えるか。02の場面が、この値ひとつで操作感がどう変わるかを示します。
残りの項目はどう押されるか — FLIPは初回測定・最終測定・逆変換・再生の4段階計算
配列が変わると残りのカードが定位置へ滑り込みますが、この動きがFLIPの計算です。Firstで並べ替え前の位置を測り、MutateでDOMの順序を変え、Lastでもう一度測り、Invertで二つの測定の差をカードに逆向きの transform としてかけて元の位置に見えるように置き、Playでその transform を0まで巻き戻します。カードは実際にはすでに新しい位置にいるのに、目には古い位置から新しい位置へ動いて見えます。
巻き戻す速さは easeOutCubic です — 残り距離の三乗根の形で動き、出だしが速くて最後に密着します。落ち着くまでの時間は FLIP_SETTLE_MS の520msです。ライブラリなしで再生を決定的にするには、Date も Math.random も使わず、時計として使うCSSアニメーションの currentTime から時間を受け取ります。この記事の九つの場面はその形なので、レンダリングをやり直しても同じ絵が出ます。
ひとつ座標の補正が付きます。デモの箱は画面の幅へ scale(k) で縮められているので、getBoundingClientRect の値は箱の座標のk倍です。そこで二つの測定の差を k で割って箱の座標へ戻し、再生倍率 FLIP_PLAY_SCALE を掛けてどれだけ遠くへ出て戻らせるかを決めます。この割り算がないと、縮んだ箱で移動距離がk倍に大きく測られます。
01移動距離を測って逆変換で巻き戻す基本縦FLIPリスト
プレイリストやお気に入りのように、いくつかの項目の順序を変える最も短い場面です。掴んだカードはゴーストで浮き、ドラッグ中は配列だけを変え、離した瞬間に残りの行が逆変換で押し込まれます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="五曲のプレイリストで二番目を最後尾へドラッグすると、残りの曲が逆変換で押されながら移動を巻き戻す場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 509줄 — 아래 「전체 코드」에서 원문 전체)// DslFlipVerticalList - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslFlipVerticalList.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 460줄 — 아래 「전체 코드」에서 원문 전체)01 · 移動距離を測って逆変換で巻き戻す基本縦FLIPリスト — 計測 累積面積 31.638% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
flipCommit の中で逆変換が決まります — 動いていないカードは0.5px未満の差を transform なしで流し、動いたカードだけが移動ベクトルを受け取ります。
// Last + Invert — 移動したぶんの逆変換ベクトルを保存する
for (const f of first) {
const r = f.el.getBoundingClientRect();
const dx = (f.x - r.left) / k * playScale;
const dy = (f.y - r.top) / k * playScale;
if (Math.abs(dx) < 0.5 && Math.abs(dy) < 0.5) {
f.el.style.transform = '';
continue;
}
moved += 1;
if (reduced) {
f.el.style.transform = '';
continue;
}
flipJobs.push({ el: f.el, dx: dx, dy: dy });
}
return moved;
離したときどう落ち着くか — 収束時間と再生倍率の二つの値
離した直後、カードがどこまで出て戻るかは二つの値が決めます。収束時間と再生倍率です。収束時間が長ければゆったり収まり、短ければすぐ密着します。再生倍率は逆変換のベクトル自体を何倍で測るかで、1.0なら測った距離の分だけ正確に動き、1.6なら実際の移動より遠くへ出て戻ります — 目には弾力のある動きと映ります。
再生曲線が easeOutCubic なので、値は最初に速く落ちて最後はほぼ止まります。同じ収束時間でも後半はほぼ留まる計算で、実際に手に残る感触は収束時間の前の30〜40%で作られます。デモの一時停止ボタンでPlayの区間を止めると、この前半がどれだけ短いかを直接見られます。
02中心が隣の中間点を越えた瞬間に場所を譲る閾値スワップ
やることリストで優先度を上へ引き上げる場面です。カードの中心が隣の中間点を通るかをその場で測り、通った瞬間に基準線が光って配列が変わります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="六行のやることリストで、ドラッグの中心が隣の中間点の基準線を越えた瞬間だけ入れ替わる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 535줄 — 아래 「전체 코드」에서 원문 전체)// DslSwapMidpoint - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslSwapMidpoint.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 479줄 — 아래 「전체 코드」에서 원문 전체)02 · 中心が隣の中間点を越えた瞬間に場所を譲る閾値スワップ — 計測 累積面積 14.581% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
注入デモでは中心がスロットの中間点を往復して通るたびに交換回数が上がります — 距離の判定の四行が操作感のすべてです。
// 判定 — 中心がどのスロットの中間点を越えるか
const slotF = (cy - 7) / (ROW_H + GAP);
const to = clamp(Math.round(slotF), 0, 5);
const cur = order.indexOf(0);
// 隣の中心との距離が閾値(0.5スロット)を越えたか — 越えなければ変わらない
const dist = Math.abs(slotF - cur);
const crossed = dist > SWAP_THRESHOLD_RATIO * 1;
if (crossed && to !== cur) {
order.splice(cur, 1);
order.splice(to, 0, 0);
layoutRows();
swaps += 1;
lastCross = f1(t) + 'ms';
}
03行をまたぐ移動まで計算するグリッド2列FLIP
アプリのランチャーのように2列グリッドで並べ替える場面です。移動が隣のマスではなく次の行へ渡るとxとyが同時に変わりますが、列と行を別々に計算してひとつの逆変換にまとめます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="2列グリッドのアイコンが斜めに次の行へ引かれると、xとyの移動を別々に測って一度に逆変換される場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 512줄 — 아래 「전체 코드」에서 원문 전체)// DslFlipGrid - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslFlipGrid.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 457줄 — 아래 「전체 코드」에서 원문 전체)03 · 行をまたぐ移動まで計算するグリッド2列FLIP — 計測 累積面積 16.731% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
中心がどのマスに近いかは割り算と丸めで出ます — 2列なので col は0か1、row は4行目までです。
// グリッド判定 — 中心点がどのマスに近いか
const cxg = x + CELL_W / 2 - GX;
const cyg = y + CELL_H / 2 - GY;
const col = clamp(Math.round(cxg / (CELL_W + GAP) - 0.5), 0, 1);
const row = clamp(Math.round(cyg / (CELL_H + GAP) - 0.5), 0, 3);
const to2 = row * GRID_COLUMNS + col;
const cur = order.indexOf(0);
if (to2 !== cur) {
order.splice(cur, 1);
order.splice(to2, 0, 0);
layoutCells();
}
04縦から横へ軸が切り替わるカンバンカラム移動
カンバンボードでカードを状態の間(やること → 進行中)へ移す場面です。縦リストの中のy移動とカラム間のx移動がひとつのFLIP計算にまとまり、軸が変わる瞬間も画面が切れません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="カンバンのカードがカラム境界を越えて「やること」へ移るとき、横移動と縦の押し出しが一つのFLIPにつながる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 550줄 — 아래 「전체 코드」에서 원문 전체)// DslKanbanAxis - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslKanbanAxis.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 486줄 — 아래 「전체 코드」에서 원문 전체)04 · 縦から横へ軸が切り替わるカンバンカラム移動 — 計測 累積面積 15.421% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
カラムの判定は幅より少し広い区間にまたがります — この余白がないと、カードが境界線の近くで左右のカラムを行ったり来たりします。
const cxg = x0 + (x1 - x0) * u + (COL_W - 10) / 2;
// 目標カラム — 境界 ±パディング判定
let tc = 0;
for (let c = 0; c < 3; c += 1) {
if (cxg >= COL_X[c] - COLUMN_HIT_PADDING_PX && cxg <= COL_X[c] + COL_W + COLUMN_HIT_PADDING_PX) {
tc = c;
break;
}
}
if (tc !== curCol || t < 500) {
if (tc !== curCol) {
const card = dragCard;
if (card) {
const from = cols[curCol].cards;
const at = from.indexOf(card);
if (at >= 0) {
from.splice(at, 1);
}
cols[tc].cards.splice(1, 0, card);
layoutKanban();
長いリストの端では何が起きるか — オートスクロールは距離を速度に変える曲線
05の場面の曲線がなぜべき乗なのかを先に書きます。速度を境界までの距離にそのまま比例させると(指数1)、ポインターが端ゾーンに入った瞬間からすでにかなりの速度で転がり、利用者が驚きます。べき乗をかけると境界から遠い側はほぼ止まり、近づくほど急に速くなります — 指数が大きいほどこの傾向が強くなります。つまり指数は速度の最大値ではなく、加速が寄り集まる位置を決める値です。
実戦ではこの曲線に、いま押しているかを held の状態として持たせて使います。この記事のデモは0.5〜1.7秒かけて端ゾーンに留まる座標を注入して曲線の加速をそのまま示し、実際に手で押す経路でも同じ式が held とともに回ります。
05端からの距離を速度曲線に変えるオートスクロール
数十件の長いリストを引いていると、目標の位置が画面の外にあります。ポインターを箱の境界の近くに置いておくとリストが勝手に転がりますが、その速度を正規化した境界距離のべき乗で計算する場面です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="長いリストでポインターが下端のゾーンに留まると、べき乗曲線に沿ってスクロールが急加速する場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 497줄 — 아래 「전체 코드」에서 원문 전체)// DslAutoscrollCurve - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslAutoscrollCurve.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 462줄 — 아래 「전체 코드」에서 원문 전체)05 · 端からの距離を速度曲線に変えるオートスクロール — 計測 累積面積 12.953% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
速度の式は数行です — 境界までの残り距離の割合 d を測り、最大速度に (1 - d)^POW を掛けます。
// 端ゾーンの進入 — 境界距離の正規化
const inEdge = ptrY > VIEW_Y + VIEW_H - EDGE_ZONE_PX;
d = inEdge ? clamp((VIEW_Y + VIEW_H - ptrY) / EDGE_ZONE_PX, 0, 1) : 1;
if (inEdge) {
const v = AUTOSCROLL_MAX_PX_S * Math.pow(1 - d, AUTOSCROLL_CURVE_POW);
lastV = v;
scrollTop = clamp(scrollTop + v * (1 / 60), 0, scrollMax);
}
else {
lastV = 0;
}
06ハンドルを掴んだときだけドラッグされる指定
行の中にリンクやチェックボックスがある設定リストでは、ドラッグの開始をハンドルへ絞ります。pointerdown の対象がハンドル要素を含むかを closest で判定し、ハンドルのときだけドラッグを始め、残りの領域は選択とスクロールのまま残します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="行の本体を押すと拒否の表示が出るだけで、ハンドルを掴んだときだけドラッグが始まる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 511줄 — 아래 「전체 코드」에서 원문 전체)// DslHandleTarget - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslHandleTarget.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 455줄 — 아래 「전체 코드」에서 원문 전체)06 · ハンドルを掴んだときだけドラッグされる指定 — 計測 累積面積 22.527% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
実際に手で押す経路の開始判定もそのまま入っています — closest が外れる条件が二つです。
scWrap.addEventListener('pointerdown', function (ev) {
const tgt = ev.target;
// ハンドル指定 — ハンドルを押したときだけ始まる。行の本体・リンクはそのまま
if (!tgt.closest || !tgt.closest(HANDLE_SELECTOR)) {
return;
}
const card = tgt.closest('.' + cx('card'));
if (!card) {
return;
}
ev.preventDefault();
dragIdx = Number(card.getAttribute('data-index'));
card.setPointerCapture(ev.pointerId);
card.style.opacity = '0.18';
gEl = makeGhost(card, LIST_X, parseFloat(card.style.top) || slotTop(0));
});
順序はどう覚えるか — インデックスの直列化とpointercancel未解放の罠
変わった順序を次の訪問まで保存するなら、DOMではなくデータを保存します。07の場面がその最小の形です — ドラッグが終わるたびに画面の順序の data-index 配列を直列化して localStorage へ入れ、次の読み込みでその配列どおりにDOMを並べ直します。
localStorage はSafariのプライベートモードで例外を投げます。try/catch なしで使うと、保存ひとつでリスト全体が止まります。
// localStorage はSafariのプライベートモードで例外を投げる — try/catch 必須
function serializeOrder() {
return rows.slice().sort(function (a, b) {
return order.indexOf(Number(a.getAttribute('data-index'))) - order.indexOf(Number(b.getAttribute('data-index')));
}).map(function (r) { return Number(r.getAttribute('data-index')); });
}
function saveOrder() {
// data-index の振り直し + 直列化
const seq = serializeOrder();
try {
localStorage.setItem(KEY, JSON.stringify(seq));
}
catch (e) {
void e;
}
}
function loadOrder() {
try {
const raw = localStorage.getItem(KEY);
if (!raw) {
return null;
}
const v = JSON.parse(raw);
if (Object.prototype.toString.call(v) === '[object Array]' && v.length === WISH.length) {
return v;
}
}
catch (e) {
void e;
}
読み込みで配列の長さが項目数と同じかまで確認するのは、保存のあとに項目が増えたり減ったりしたとき、対応の合わない配列でDOMを並べる事故を防ぐためです。保存のキーは dsl523.order で、保存される値は [5,0,1,2,3,4] の形です。
07変わった順序をインデックスに直列化して保存する順序維持
最後の行を三つ分上へ引くと保存の表示が出て、続く読み込み直しのフェードで保存された配列どおりに復元されます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ドラッグが終わるたびに順序の配列が保存され、読み込み直すとその配列どおりにリストが復元される場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 549줄 — 아래 「전체 코드」에서 원문 전체)// DslOrderPersist - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslOrderPersist.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 481줄 — 아래 「전체 코드」에서 원문 전체)07 · 変わった順序をインデックスに直列化して保存する順序維持 — 計測 累積面積 21.61% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
保存は離したあとの後始末の最後で起きます — flipCommit で並べ替えを済ませたあと saveOrder を呼び、項目の下の行に保存した値を出します。
flipCommit(scWrap, function applyHand7() {
const sorted = rows.slice().sort(function (a, b) {
return order.indexOf(Number(a.getAttribute('data-index'))) - order.indexOf(Number(b.getAttribute('data-index')));
});
for (const s of sorted) {
scWrap.appendChild(s);
}
layoutRows();
}, 1.0, performance.now(), 380);
saveOrder();
if (chipEl) {
chipEl.textContent = '保存 ' + JSON.stringify(serializeOrder());
}
dragIdx = -1;
}
pointercancel も同じ後始末の経路で入ります — 指の入力がキャンセルされても順序は配列にすでに反映されているので、保存するだけで済みます。
08ドラッグ速度がゴーストの傾きを変える慣性チルト
画像ギャラリーの並べ替えの感触を足す場面です。直近のフレームの移動量から速度を計り、浮いているゴーストの傾きと影の濃さへ比例させ、速度が消えると傾きもlerpで戻ります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ドラッグ速度に比例してゴーストが傾き影が深くなり、速度が消えるとlerpで戻る場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 523줄 — 아래 「전체 코드」에서 원문 전체)// DslGhostTilt - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslGhostTilt.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 479줄 — 아래 「전체 코드」에서 원문 전체)08 · ドラッグ速度がゴーストの傾きを変える慣性チルト — 計測 累積面積 28.586% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
傾きは速度に係数を掛けて最大角に留める一行で、影は速度の絶対値で深さを受け取ります。注入デモも実際の手の経路も同じ applyTilt を使います。
// 速度→傾き・影の計算 — 注入デモも実際の手の経路も同じ関数を使う
function applyTilt(v, dt) {
const tilt = clamp(-v * GHOST_TILT_MAX_DEG / 600, -GHOST_TILT_MAX_DEG, GHOST_TILT_MAX_DEG);
// v→0 なら lerp で戻る (速度がないとき傾きもない)
const back = Math.abs(v) < 40 ? 0.18 : 1;
tiltNow = lerp(tiltNow, tilt, back);
shadowNow = lerp(shadowNow, GHOST_SHADOW_BASE_PX + Math.abs(v) * 0.012, 0.2);
velLast = v;
if (gEl) {
gEl.style.transform = 'rotate(' + f1(tiltNow) + 'deg)';
gEl.style.boxShadow = '0 ' + f1(shadowNow + 4) + 'px ' + f1(shadowNow * 3) + 'px rgba(0,0,0,.45)';
}
09矢印キーで一つずつ動かすキーボード代替整列
フォーカスされた項目で上下の矢印が入るたびに隣の項目と場所を交換してFLIPで示し、変わった順序を文で知らせる場面です。ポインターが使えない環境での並べ替えの受け口です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="矢印キー一回で隣と入れ替わり、FLIPで押されて、新しい順序が文で知らされる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 523 공통 — 드래그 정렬 리스트 (520 base.scss 계승, gooey 계층 제거·카드 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 474줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 503줄 — 아래 「전체 코드」에서 원문 전체)// DslKeyboardReorder - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DslKeyboardReorder.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 523 드래그 정렬 공통 — 무대 좌표·문구 틀·요소 조립 (520 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 449줄 — 아래 「전체 코드」에서 원문 전체)09 · 矢印キーで一つずつ動かすキーボード代替整列 — 計測 累積面積 3.505% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
交換の相手は clamp の一行です — 現在の位置に向き × KEY_STEP_SLOTS の1を足して0〜4の中に留めます。
function swap(dir, t) {
const cur = order.indexOf(focusIdx);
const to = clamp(cur + dir * KEY_STEP_SLOTS, 0, 4);
if (to === cur) {
return;
}
keyCount += 1;
movedN = flipCommit(scWrap, function applyKey() {
order.splice(cur, 1);
order.splice(to, 0, focusIdx);
const sorted = rows.slice().sort(function (a, b) {
return order.indexOf(Number(a.getAttribute('data-index'))) - order.indexOf(Number(b.getAttribute('data-index')));
});
const lb = scWrap.querySelector('.lbwrap');
if (lb) {
for (const s of sorted) {
lb.appendChild(s);
}
}
layoutRows();
announce();
}, 1.0, t, 320);
フォーカスの維持と読み上げの文が、この場面のアクセシビリティの層です。
// フォーカス維持 — 項目が動いてもフォーカスはその項目に残る (スクロール強制はしない)
const fe = rows[focusIdx];
if (fe && document.activeElement === fe) {
fe.focus({ preventScroll: true });
}
function announce() {
// 画面読み上げの文 — 表現・モードが変わるときだけ更新する (毎フレームの数字はしない)
const seq = rows.slice().sort(function (a, b) {
return order.indexOf(Number(a.getAttribute('data-index'))) - order.indexOf(Number(b.getAttribute('data-index')));
}).map(function (r) { return r.querySelector('.card__tx').textContent; }).join(', ');
doneP.textContent = '新しい順序: ' + seq;
}
こういう画面に付ける
ドラッグ並べ替えが実際に暮らす場所は、おおむね三つに集まります。プレイリスト・お気に入り・ウィッシュリストのように利用者が自分の順序を持つ短いリスト(01・02・07)、カンバンやスプリントボードのように状態のカラムの間を行き来する作業の画面(04)、ランチャー・ギャラリー・ウィジェット編集のように格子に置かれた編成の画面(03・08)です。長さが画面を超えた瞬間に05を足し、行の中にほかの操作があれば06で絞り、キーボードでの操作が要るなら09を付けます。
短いリストに曲線のオートスクロールまで足す過剰は避けます。項目が一面の中に全部見えているなら05は死んだコードで、この記事の九つの場面も、それぞれ付けどきのある計算であって、全部を重ねるチェックリストではありません。逆に実務で最も抜けやすいのは09のキーボードの経路と07の保存で、どちらも最後に付けようとするとリストの構造をもう一度触ることになるので、配列をdataで持つ設計、つまり01を作る瞬間から入れておきます。
どこで壊れるか — 初回測定の呼吸・pointercancel・選択・touch-action・中間点の震い
この記事の場面を作りながら実際にぶつかった落とし穴を六つ挙げます。壊れる条件と直し方を並べて書きます。
一つ目は、FLIPの初回測定の呼吸です。First を測ったあとDOMを直し、Last を測るまでの間に強制リフロー(画面外での測定・display の切り替え)を挟むと First の値がずれて、カードが違う方向から飛んできます。直し方は同じフレームの中で連続して測ることと、箱が scale(k) で縮んでいるので rect の差を k = rootEl.clientWidth / 480 で割って箱の座標へ戻すことです — この補正がないと、縮んだ箱で移動距離がk倍に大きく測られます。
二つ目は、ドラッグ中のリフローです。ゴーストを実際のカードの移動で代用すると、pointermove のたびにレイアウトが計算し直されます。直し方はゴーストを position: absolute の複製で浮かせ、元はopacityだけ変える構造です — makeGhost がその構造そのもので、元は文書の流れに残っているので、残りのカードの位置は配列が変わるときだけ動きます。
三つ目は、pointercancel の未解放です。指が画面の外へ出るか、システムが操作を奪うと pointerup が来ません。pointercancel を離すときと同じ後始末の経路にまとめないと、ゴーストが画面に残ります — この記事の九つの場面はすべて pointercancel → release でまとめてあり、05のようにrAFのループが生きている場面はループまで切ります。残るのはゴーストだけではありません — 07の保存も離す経路で起きるので、同じ鎖で自然に解けます。
四つ目は、テキスト選択・画像ドラッグとの衝突です。ドラッグの開始を止めないと、文字の選択がドラッグに勝ちます — カードを引くと、カードではなく文字が青く選択されます。直し方はカードに user-select: none を与えることで、06の設計(行の本体はドラッグ不可)と合わせると、選択が要る領域は生かし、ドラッグが要る領域だけが閉じます。
五つ目は、タッチのスクロールとの衝突です。カードに touch-action: none を与えないと、指のドラッグがページのスクロールに奪われます。だからといって、スクロールが生きていなければならないリストの箱まで none にすると、こんどはリストが転がらなくなります。直し方は領域ごとの分離です — カードは none、05のリストの箱は pan-y にして縦のスクロールを生かして残します。06のデモで拒否される行の本体の押し下げは、この分離がないときに指で何が起きるかを見せるものです。
六つ目は、丸めが作る中間点の震いです(02のデモ)。スロットの判定を Math.round((cy-7)/(ROW_H+GAP)) だけにすると、中心がスロットの中間点の近くで行ったり来たりするたびに配列が変わって項目が震えます。直し方は判定の重ねです — 元のスロットとの距離が SWAP_THRESHOLD_RATIO を越えなければ変わらないというヒステリシスです。この一行がないと、同じコードがデスクトップのマウスでは正常なのに、タッチでは震える理由になります。
値を変えたときの違い
三つの変形は、それぞれ定数を一つだけ変えた前後の違いを場面で直接見られます。
| 名前 | 変えた値 | 感触 |
|---|---|---|
| 入れ替え閾値を半スロットに調整する | 02 SWAP_THRESHOLD_RATIO 0.5 → 0.85 | 0.5は中間点の通過ですぐ入れ替わるので軽くなでただけで場所が変わるのに対し、0.85は隣をほぼ覆うまで変わらず、大きく動かす必要があります — 誤って入れ替わることは減り、そのぶん正確に引くには力が要ります |
| FLIP移動の再生倍率を調整する | 01 FLIP_PLAY_SCALE 1.0 → 1.6 | 逆変換の最初の距離が実測の1.6倍になり、押される行が実際より遠くへ出て戻ります — 1.0は測った距離の分だけ動く淡白さ、1.6は実際より遠くへ出て戻る軽い弾みとして映ります |
| オートスクロール速度曲線の傾きを調整する | 05 AUTOSCROLL_CURVE_POW 1.2 → 2.4 | 1.2は端ゾーンの中で比較的均等に加速して穏やかで、2.4は境界の近くまで遅いまま一気に加速して指先の反応が鋭くなります — 同じ最大速度なのに指数だけで操作感が分かれます |
九つの場面のソースとreact版をまとめたzipは下の箱から受け取れます。解凍のパスワードは g3zfh9gy です。閾値の判定・FLIPの逆変換・曲線の加速がライブラリなしでそれぞれ何行かを、コードで直接確かめられます。
ポインターなしで使う経路 — 09のキーボード並べ替えとprefers-reduced-motion
09の場面がそのまま実戦用の骨格です。role="listbox" の中に項目を option として置き、roving tabindex で運びます — フォーカスは常に項目ひとつだけに(残りは tabindex -1)あり、順序が変わるとフォーカスもその項目についていきます。fe.focus({ preventScroll: true }) がその移動です。スクロールの強制を切らないと、キーひとつで画面が跳ねます。状態の行は aria-live を切っておき、完成した文だけを role="status" aria-live="polite" で読み上げます — 毎フレームの数字を読むと画面読み上げが混雑するからです。
prefers-reduced-motion がオンのときはFLIPの再生を飛ばして、決まった状態へ切り替えます — flipCommit の reduced の分岐が transform を空にするので、置く前と置いた後の二つの状態だけが見えます。キー入力とドロップは再生なしでも目標の更新の直後に画面へ映るので、操作は死にません。
caniuse で2026-11-16に直接確認した値です。Pointer Events API は Chrome 55+ · Firefox 59+ · Safari 13+ で全体の97.49% — この記事の九つの場面の基盤です。HTML5 の draggable は全体の97.57%で数値は高いのですが、モバイルのブラウザーがネイティブのD&Dのイベントを送らない隙間があるので、タッチまでをひとつの経路で兼ねるなら Pointer Events が正解です。touch-action は Chrome 36+ · Firefox 52+ · Safari 13+、prefers-reduced-motion は Chrome 74+ · Firefox 63+ · Safari 10.1+ です。JavaScriptが切れた環境では、リストはただの静的な一覧として残ります — ドラッグ並べ替えは漸進的な拡張で、保存が失敗しても(localStorage の例外)リスト自体は動きます。
読者のコードへそのまま移すときの最小のガードは下の数行です。
@media (prefers-reduced-motion: reduce) {
.card { transition: none; }
}
ドラッグ並べ替えでよくある質問 — モバイル・保存・ライブラリ
html ドラッグアンドドロップ 並び替えはモバイルのタッチでも動きますか
動きます。九つの場面はすべて Pointer Events が基盤なので、マウス・タッチ・ペンを同じハンドラーで受けます。ただしカードに touch-action: none を与えないと指のドラッグがページのスクロールに奪われ、リストが長くてスクロールが要るときは箱を pan-y に分けます。caniuse の確認(2026-11-16)では、iOS Safari は13.2+ で全体が対応しています。
変わった順序は保存されますか
07の場面が保存の層の全部です。ドラッグが終わるたびに data-index の配列を直列化して localStorage へ入れ、読み込みで復元します。Safariのプライベートモードの例外を防ぐ try/catch と、項目数が変わったあとの対応の確認までが実戦のコードで、サーバーへ上げるには同じ配列を fetch で送るだけです。
react ドラッグアンドドロップ 並び替えのライブラリは必要ですか
必要ありません — このページの九つの場面がすべてライブラリなしで動いています。核は中心点の通過の判定ひとつ(02)とFLIPの四段階(01)だけで、残りはその二つの計算の変形です。drag and drop list の作例を探して回るより、このページで各場面のソースをそのままコピーして貼り付ければ、ページを離れずに動かせます。
関連する記事はドラッグで並べ替えるUIパターン・ドラッグアンドドロップの物理パターン・リストが広がるチェックリストUIへと続きます。出典: MDN Pointer events · MDN transform · MDN touch-action · MDN getBoundingClientRect









