GODRICH
#cssアニメーション#ボタン#ローディング#トランジション#スクロール#ダッシュボード#実用ui#デザイントレンド

javascript 引っ張って更新 9種 — 閾値と弾性のコピペ

引っ張って更新は、最上部の下向きドラッグを距離として数え、離した瞬間に判定するUIです。指のドラッグ距離が1:1で追従したあと弾性抵抗曲線へ変わります。累積距離が閾値を越えた瞬間にアイコンが発射準備状態へスナップし、離した判定がスプリング復帰と更新実行に分かれる計算が、プルトゥリフレッシュ全体をライブラリなしで動かしま

zip の中身と開き方

九つの場面の順番は、作る順番そのものです。01の累積ドラッグの発射判定、02の弾性抵抗曲線、03の進行アイコンの回転、04の離しの二分岐、05の実行中のフィード更新、06の完了チェックの自動close、07の遅延読み込みとの連動、08のデスクトップのボタンのフォールバック、09のオフへの切替。前の四つが判定と操作感で、後の五つが実戦の画面でこの判定が出会う状況です。

先にひとつ書いておきます — 各場面の自動再生は、決定的な座標の並びを判定の関数に注入する注入デモです。人が pointerdown・pointermove・pointerup で操作すれば同じハンドラーの連なりを通りますが、下の測定値・gif・ポスターの動きはすべてこの注入デモの結果であって、手操作の実測ではありません。

引っ張って更新は、スクロールが最上部に張り付いた状態で縦ドラッグが始まったときだけ起動する判定です — scrollTop 0 の確認を省くとリストの途中で更新が始まります

引っ張って更新は、スクロールが最上部に張り付いているときだけ有効な、条件付きの入力です。リストの途中での下向きスワイプは更新ではなくスクロールでなければならないので、最初の検査はいつも scrollTop === 0 です。この検査を省くと、フィードを送って読んでいる途中に指が触れたすべての縦ドラッグが発射の候補になり、リストの途中で更新が始まります。

判定は四段階にまとまります。最上部の確認 → 下向きドラッグで生の距離(raw)を累積 → 生の距離を弾性変換して表示距離へ変える → 離した瞬間に表示が閾値を越えているか再判定。01の場面がこの四段階すべてをひとつの画面で回し、残りの八つは各段階をひとつずつ拡大します。

タッチイベントとポインターイベントのどちらで受けるかもここで決めます。このデモは pointerdown・pointermove・pointerup を使い、タッチとマウスが同じイベントで届くので、08のデスクトップのフォールバックがコードの追加なしで自然につながります。

touchstart・touchmove の併記は、Pointer Events に対応しない古いSafariへの案内のコメントとしてだけ残っています。

引っ張って更新9種 — 基本ドラッグ発射・弾性抵抗曲線・進行アイコン回転・離し二分岐・実行中フィード更新・完了チェック自動close・遅延読み込み連動・デスクトップボタンフォールバック・オフ切替

測定は 도구/demo.py が2秒間の場面を24枚の静止画に収め、隣り合う二枚の差23個から動きを読んだものです(測定時刻 2026-11-17 03:49、01のみ03:54に再レンダリング)。表の数値は自動再生の注入デモによるもので、手操作の実測ではありません — この区切りは冒頭に書いたとおりです。

場面 累積面積 強度 動いたフレーム
01 基本ドラッグ発射 24.5% 154.9 23/23
02 弾性抵抗曲線 38.7% 128.3 23/23
03 進行アイコン回転 4.8% 105.3 23/23
04 離し二分岐 21.1% 168.2 23/23
05 フィード順次更新 28.5% 151.0 23/23
06 完了チェック自動close 28.0% 159.9 23/23
07 遅延読み込み連動 34.6% 138.0 23/23
08 デスクトップボタンフォールバック 23.6% 152.9 23/23
09 オフ切替 20.7% 157.2 23/23

面積が最も大きい02は、飽和曲線の生のバーと表示のバーが一緒に動いて場面の全面へ広がる盤で、07はリストの両端が同じだけ動く盤です。03が4.8%で最も小さいのは、リング・角度・進行バーという閾値スナップそのものが小さい部品だからで、もともと面積が小さいのが正しく、その代わり normalize の値が角度とバーの幅へ二重に伝わる精密さがこの場面の分担です。

累積面積は最初の枚からどこかで変わった画素の割合、強度はその変わった分の色差の平均(0〜255)、動いたフレームは直前の枚と比べて変化のあった枚の数です。

どれだけ引けば発火するか — 発射閾値はピクセル距離で、その値が操作感の半分を決めます

閾値 FIRE_THRESHOLD_PX は70pxに取りました。この値は表示距離の基準です — 指が実際に下がった生の距離ではなく、弾性変換を通ったあとの目に見える距離が70pxに届いて初めて発射準備が点きます。生で130px引くと表示は約73pxになって、ぎりぎり閾値を越えます。

70という数値は感覚ではなく根拠があります。表示の70pxは親指の関節ひとつぶんの移動距離で、少し引いたという手応えの場所です。生にすると約125px引かないと届かないので、偶然触れたドラッグでは到達しません。値を下げれば軽く更新されますが思いがけず発射しやすくなり、上げれば確信のある更新になります — この均衡が下の変形の表の最初の行です。

閾値を越えるかどうかは毎フレーム計算し直されます。越えてから戻れば発射準備は解け、離した瞬間の armed の値で最終判定です。引いている途中で何度閾値を行き来しても、離したときの値だけが残ります。

01累積ドラッグ距離が閾値を越えると発射する基本判定

フィードの最上部で新しいリストを受け取る基本形です。生のドラッグが弾性変換を通って閾値70pxと毎フレーム比較され、離した瞬間の通過判定で実行が決まり、通過すれば620msの実行表示のあと新しい3件がリストの頭に現れます。

累積ドラッグ距離が閾値を越えると発射する基本判定
全文コード 新しいタブで開く

01 · 累積ドラッグ距離が閾値を越えると発射する基本判定 — 計測 累積面積 24.501% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

FIRE_THRESHOLD_PXscrollToptouchstart

コードで見るところ

判定の本体は apply01 の4行で、最初のコメントが実務では最初の行になる検査を示しています。

    function apply01(raw) {
        // scrollY === 0(scrollTop と同じ値)の判定はこのデモの舞台(固定)がすでに満たす — 実務ではここを先に検査する
        p01.raw = Math.max(0, raw);
        p01.disp = elasticMap(p01.raw, RESIST_START_PX, ELASTIC_SATURATE, RESIST_K);
        p01.armed = p01.disp >= FIRE_THRESHOLD_PX;
        if (bar01) {
            bar01.style.transform = 'translateY(' + f1(p01.disp) + 'px)';
        }
    }

なぜだんだん引けなくなるか — 弾性抵抗曲線は距離を1:1から1:0.5飽和へ変える比率関数です

iOSのラバーバンドの手応えは抵抗から生まれます。iPhone 引っ張って更新 の操作感が気持ちいいとされるのは、指が下がった分だけ画面がついてきて、ある地点からは同じ距離を動かしても画面がだんだん下がらなくなるからです。

これをひとつの関数に圧縮したのが elasticMap です。生の距離は RESIST_START_PX の22pxまでは1:1でそのまま、その上では超過分の0.35乗に飽和比率 ELASTIC_SATURATE の0.5を掛けて半分以下へ縮めます。

    function elasticMap(raw, resPx, sat, k) {
        if (raw <= resPx) {
            return raw;
        }
        const prog = 1 - resPx / Math.max(raw, 1);
        return resPx + (raw - resPx) * sat * Math.pow(clamp(prog, 0.05, 1), k);
    }

数値で確かめます。生130pxの表示は 22 + 108 × 0.5 × 0.938 ≈ 72.7px で比率0.56、生170pxの表示は ≈92.5px で比率0.54です。生が30%深く下がっても表示は28%しか下がらない — この収束が飽和で、いくら強く引いても画面が無限に伸びない理由です。

02距離を1:1から1:0.5飽和へ変える弾性抵抗曲線

ドラッグの操作感を整える出発点です。半透明の幽霊のバーが指の生の距離をそのまま追って下がり、硬い実体のバーは弾性変換された表示距離だけ下がり、二つをつなぐ線が抵抗に食われた距離をリアルタイムで示します。

距離を1:1から1:0.5飽和へ変える弾性抵抗曲線
全文コード 新しいタブで開く

02 · 距離を1:1から1:0.5飽和へ変える弾性抵抗曲線 — 計測 累積面積 38.701% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

ELASTIC_SATURATERESIST_START_PXtranslateY

コードで見るところ

深く引いた区間(生170px)で幽霊と実体の間が最も開き、比率が0.54へ収束するのがクライマックスで、マウスで直接引いても同じ elasticMap が pointermove で動きます。

    sceneEl.addEventListener('pointermove', function (ev) {
        if (down02 && flt02) {
            const raw = Math.max(0, stagePoint(ev).y - 40 - base02);
            flt02.style.transform = 'translateY(' + f1(elasticMap(raw, RESIST_START_PX, ELASTIC_SATURATE, RESIST_K)) + 'px)';
        }
    });

閾値を越えると何が起きるか — アイコン状態切替は角度・色・スナップが1フレームで分かれます

閾値の通過を目で知らせる標準が進行アイコンです。ドラッグ距離を normalize(raw/70) で0〜1に束めて ROT_MAP_MAX_DEG の360を掛け、conic-gradient の埋める角度へ代入すると、引いた分だけリングが埋まり、満ちる瞬間がそのまま閾値です。進行バーの幅も同じ normalize 値で伝えて、アイコンが小さくても進みが面積で読めます。

03ドラッグ距離を回転角に写像し閾値でスナップする進行アイコン

pull to refresh icon の席に収まる場面です。リングが0度から360度へ埋まっていき、normalize 値が1に届くフレームで armed へスナップし、160msのトランジション(ARM_SNAP_MS)が角度と色の入れ替えを点滅ではなくスナップに見せます。

ドラッグ距離を回転角に写像し閾値でスナップする進行アイコン
全文コード 新しいタブで開く

03 · ドラッグ距離を回転角に写像し閾値でスナップする進行アイコン — 計測 累積面積 4.813% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

ROT_MAP_MAX_DEGARM_SNAP_MSnormalize

コードで見るところ

写像の核は normalize を距離から角度へ渡す3行で、同じ値が進行バーの幅へも伝わります。

    function apply03(raw) {
        p03.raw = Math.max(0, raw);
        const n = clamp(p03.raw / FIRE_THRESHOLD_PX, 0, 1); // normalize — 0〜1 へ正規化
        p03.rot = n * ROT_MAP_MAX_DEG;
        p03.armed = n >= 1;
        if (ndl03) {
            ndl03.style.background = 'conic-gradient(' + f0(p03.rot) + 'deg, ' + f0(p03.rot) + 'deg, rgba(255,255,255,0) 0deg)';
        }

指を離すとどうなるか — 離し判定は未達のスプリング復帰と通過の実行に二分されます

離した瞬間の再判定が、引っ張って更新の最後の分かれ道です。表示が閾値より上なら実行状態へ切り替えてアイコンを上部に固定し、未達なら減衰しながら振動するスプリングが定位置へ巻き込みます。スプリングは v += (−0.12x − 11v)dt を毎フレーム積分する2行です — 剛性 SPRING_STIFFNESS の0.12が引く力、減衰の11が抑える力です。

未達の復帰にスプリングを使うのは、失敗が成功と同じ物理を通すためです。通過時の実行固定と未達時の一度の巻き込みだけでも動きますが、二、三度跳ねて静まるバーは「外した」というフィードバックを、指が覚えている手応えとして渡します。

04離し判定が未達スプリング復帰と通過実行に分かれる二分岐

うっかりドラッグを無害に戻す場面です。表示55px、つまり閾値70pxを下回って離すとスプリングが巻き戻しながら跳ねた回数をカウンタに積み、同じ場面で閾値を越えて離せば実行固定へ分かれます。

離し判定が未達スプリング復帰と通過実行に分かれる二分岐
全文コード 新しいタブで開く

04 · 離し判定が未達スプリング復帰と通過実行に分かれる二分岐 — 計測 累積面積 21.115% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

RETURN_DAMPINGSPRING_STIFFNESSrequestAnimationFrame

コードで見るところ

スプリングの積分と跳ねの判定がこの分岐の本体で、跳ねの判定は速度の符号が変わった回数を数えるだけなので別の物理は要りません。

    function springStep(sp, stiff, damp, dtms) {
        const dt = dtms / 1000;
        sp.v += (-stiff * sp.x - damp * sp.v) * dt;
        sp.x += sp.v * dt;
    }
        if (mode04 === 'spring') {
            // 未達復帰 — 減衰スプリングを requestAnimationFrame のティックごとに積分する
            springStep(sp04, SPRING_STIFFNESS, 11, 1000 / 60);
            if (lastV04 !== 0 && sp04.v * lastV04 < 0) {
                bounces04 += 1;
            }
            if (sp04.v !== 0) {
                lastV04 = sp04.v;
            }
            disp = Math.max(0, sp04.x);

05新しい項目が順に流れ込む実行中フィード更新

通知・ニュースフィードの新着受け取りに使う場面で、発射のあとスピナーが ARMS_PERSIST_MS の300msをこらえてから新しい3件が STAGGER_MS の120ms間隔で発射+300・420・540msに順に届き、各行は上18px・横0.85倍から定位置へ落ち着くFLIP逆変換で流れのように読めます。

新しい項目が順に流れ込む実行中フィード更新
全文コード 新しいタブで開く

05 · 新しい項目が順に流れ込む実行中フィード更新 — 計測 累積面積 28.51% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

STAGGER_MSARMS_PERSIST_MSaria-live

コードで見るところ

到着の判定とFLIPの補間がひとつのループに収まっています。

        for (let k = 0; k < NEW_N; k += 1) {
            const born = fire + ARMS_PERSIST_MS + k * STAGGER_MS - 2000;
            const it = items05[k];
            if (t >= born && it.born !== born) {
                it.born = born;
                // FLIP逆変換 — 目標の枠(at)に対し初登場時に上18pxの逆変換から定位置へ落ち着く
                it.el.className = cx('row row--new');
                it.el.style.transform = 'translateY(' + (it.at - 18 - 8 - k * 26) + 'px) scaleX(0.85)';
                it.el.style.opacity = '0.4';
            }

完了の知らせは role="status" の文が「新しい項目3件到着 — 更新完了」をモードの変わる瞬間にだけ書き換え、読み上げが到着のたびに数字を読まないようにしています。

06完了チェックへ変わり時間で自動的に閉じる収束

更新の終わりをひと目で知らせる場面です。更新が終わるとスピナーがチェックへ変わり、stroke-dashoffset の40→0の経路描画(260ms)でチェックが描かれ、400msとどまったあと340msで cubic-bezier(0.22, 1, 0.36, 1) のイージングで上へ巻かれるように閉じます。

完了チェックへ変わり時間で自動的に閉じる収束
全文コード 新しいタブで開く

06 · 完了チェックへ変わり時間で自動的に閉じる収束 — 計測 累積面積 27.983% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

DWELL_MSstroke-dashoffsetAUTOCLOSE_EASE

コードで見るところ

チェックの描画と自動closeが同じブロックで時刻によって分かれ、stroke-dasharray を40に置いて offset を40から0へ減らすこの経路描画は pathLength 基準なので、チェックの形が何ピクセルでも同じ時間で描けます。

        if (check06) {
            if (t >= drawStart && t < closeStart + AUTOCLOSE_MS) {
                check06.style.opacity = '1';
                const u = clamp((t - drawStart) / DRAW_MS, 0, 1);
                // stroke-dashoffset 40 → 0 — 経路が描かれる分だけ埋まる
                check06.style.strokeDashoffset = f1(40 * (1 - u));
                const cl = clamp((t - closeStart) / AUTOCLOSE_MS, 0, 1);
                check06.style.transition = 'transform ' + AUTOCLOSE_MS + 'ms ' + AUTOCLOSE_EASE;
                check06.style.transform = 'translateY(' + f1(-48 * cl) + 'px)';
            }

07下側の遅延読み込みとつながるリスト回転連動

無限スクロールと引っ張り更新の共存の場面です。上端はドラッグの閾値が新しい項目を受け取り、下端は IntersectionObserver のセンティネルが次の束(PAGE_SIZE の3件)を受け取り、センティネルの data-page 属性が1から3へ増えて受け取った束が続きます。

下側の遅延読み込みとつながるリスト回転連動
全文コード 新しいタブで開く

07 · 下側の遅延読み込みとつながるリスト回転連動 — 計測 累積面積 34.561% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

PAGE_SIZEIntersectionObserverdata-page

コードで見るところ

オブザーバーの root を場面の要素に指定したことが壊れる瞬間の節の六つ目に直結していて、受け取った束は220msのFLIPで着地します。

時演(スクロール強制)と実際の画面が同じオブザーバーを共有する点も、この root の指定が前提です。

    let io07 = null;
    function startIO() {
        // IntersectionObserver — センティネルが場面の下端に触れると appendPage。実際の画面と
        // 時演(スクロール強制)が同じオブザーバーを共有する
        io07 = new IntersectionObserver(function (ents) {
            for (let i = 0; i < ents.length; i += 1) {
                if (ents[i].isIntersecting && page07 < 3) {
                    appendPage();
                }
            }
        }, { root: sceneEl, threshold: 0.6 });
        if (sent07) {
            io07.observe(sent07);
        }
    }

デスクトップでは — マウスドラッグ代替とボタンフォールバック、reduced-motion では即時復帰

タッチのない画面でも入力が途切れないようにする二つを、08が一緒に担います。ひとつはコンテナ内の縦ドラッグを pointerdown で受け、同じ elasticMap と閾値70pxの計算をそのまま再利用することです。ポインターイベントなので、マウスのドラッグがタッチと同じコードを通ります。

もうひとつはドラッグが不自然な場所のために「今すぐ更新」ボタン(aria-label)を常に示して、クリック・Enter・Space のどの経路でも発射が届くようにすることです。

08マウスドラッグ代替とボタンフォールバックを併せるデスクトップ経路

デスクトップ・トラックパッド・支援技術が共用する画面の場面です。マウスドラッグで閾値を越えて離す経路とボタンを押す経路が同じ fire08 で出会い、prefers-reduced-motion がオンでもボタンのクリックはすぐ実行されます。

マウスドラッグ代替とボタンフォールバックを併せるデスクトップ経路
全文コード 新しいタブで開く

08 · マウスドラッグ代替とボタンフォールバックを併せるデスクトップ経路 — 計測 累積面積 23.585% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

pointerdownprefers-reduced-motionaria-label

コードで見るところ

マウスドラッグの終了判定が閾値の再利用をそのまま示していて、未達ならバーを定位置へ戻します。

    function endDrag08() {
        if (!down08 || !bar08) {
            down08 = false;
            return;
        }
        down08 = false;
        const ty = parseFloat(bar08.style.transform.replace('translateY(', '').replace('px)', '')) || 0;
        if (ty >= FIRE_THRESHOLD_PX) {
            fire08();
        }
        else {
            bar08.style.transform = 'translateY(0)';
        }
    }

09ブラウザ標準ドラッグとの衝突を断ちオンオフするoverscroll切替

引っ張って更新を止めたい要求に応える場面です。overscroll-behavior-y: contain でChrome標準の更新を防いだコンテナの中で、切替をオフにすると閾値の判定とリスナーを removeEventListener で一緒に外し、ブラウザの既定の動作が戻るところまで示します。

ブラウザ標準ドラッグとの衝突を断ちオンオフするoverscroll切替
全文コード 新しいタブで開く

09 · ブラウザ標準ドラッグとの衝突を断ちオンオフするoverscroll切替 — 計測 累積面積 20.667% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

overscroll-behavior-yremoveEventListenertouch-action

コードで見るところ

最初の周期(0〜1秒)はオンの状態でドラッグが発射まで進み、1秒で切られて、次の周期は計器の針が6px揺れるだけでバーがついてきません。

    function toggle09() {
        on09 = !on09;
        if (tg09) {
            tg09.textContent = on09 ? 'オフにする' : 'オンにする';
            tg09.setAttribute('aria-pressed', on09 ? 'true' : 'false');
            tg09.className = cx(on09 ? 'tg09 is-on' : 'tg09 is-off');
        }
        if (cap09) {
            cap09.textContent = on09 ? '独自ドラッグ有効' : 'ブラウザ既定に戻った';
        }

こういう画面に付ける — ドラッグが生きる場所

「引っ張って更新 スマホ」で探して辿り着く画面は、ほぼ四つに集まります。通知・メッセージのリスト(01・05)、ニュース・SNSのフィード(02・06)、無限スクロールのリスト(07)、ダッシュボード・管理画面(08)です。モバイルの画面では、フィードの最上部がそのまま更新ボタンになる入力なので、リストの頭に何を見せるかを決める作業と出発点が同じです。

実務の判断を二つ書きます。ひとつは実行中の画面です。発射のあとは必ず05・06のように「取得している途中」の状態を見せます — わずかな通信の遅延でも表示がなければ「押れなかったのか」ともう一度引かせることになります。もうひとつは失敗の処理です。取得が失敗したら、06のチェックの代わりに案内の文で閉じます。完了チェックを失敗のときまで見せると、更新されたという嘘になります。

管理画面のようにデスクトップの比重が高い画面では、08を基本にします。マウスで縦ドラッグを真似るよりボタンのほうが速く、キーボードの利用者にはボタンが唯一の経路でもあります。

壊れる瞬間 — Chrome標準の更新と重なる — overscroll-behavior-y: contain が無いとブラウザが先に引っ張られます、touchmove と縦スクロールの競合もここで判定します

デモを作りながら実際にぶつかったものを七つ書きます。それぞれ再現した状況と直し方までです。

ひとつ目は overscroll-behavior-y: contain がないと、ブラウザが先に引っ張られることです。Android 引っ張って更新 の既定の動作は、ページ最上部で下向きのドラッグが始まると自分の更新を先に発動することで、独自の判定はその後ろにすら立てません。

このデモの九つ全部のscssに .ez__pad { overscroll-behavior-y: contain; } が最初の行として入っているのはこのためです。

caniuse で2026-11-17に直接確認した支持は全体の97.17% · Chrome 65+ · Firefox 59+ · Safari 16+ で、Safari 15以前は contain が効きません(14.1〜15.6は部分対応・既定でオフ)。古いSafariでは touchmove の preventDefault の補助が別途要ります。

ふたつ目は touchmove と縦スクロールの競合です。コンテナに touch-action: none を置かないと、pointermove が届く前にスクロールが勝って、ドラッグの距離は0の近くに留まります。09の切替がオフのとき touch-action まで戻すのは、この二行がひと組だからです — 片方だけ戻すとブラウザの既定が完全には戻りません。

三つ目は最上部の判定の省略です。scrollTop === 0 の確認がないと、リストの途中での下向きスワイプがすべて発射の候補になります(01の最初のコメント)。舞台を固定にしたデモでさえコメントで明示するのは、実務ではこの検査がそのまま最初の行だからです。

四つ目は pointercancel の抜けです。離しの判定を pointerup だけに置くと、指が画面の外へ出るかブラウザのジェスチャーが割り込んで pointercancel で終わったドラッグが、永遠に「引いている途中」のまま残ります。01・04・05・07・08がすべて pointercancel のリスナーを同じ判定へ流しています。

五つ目は armed スナップのトランジションの欠如です。03の ARM_SNAP_MS の160msを外すと、角度と色の入れ替えが1フレームの点滅になります。状態の切替に時間を与えるのは飾りではなく、切替が読めるための最小限です。

六つ目は IntersectionObserver の root の抜けです。07のようにセンティネルが画面の一部(このデモでは場面の要素)の中にいるとき、root を指定しないとビューポート基準の判定になって、デモの外のスクロールに反応します。root: sceneEl, threshold: 0.6 の二つの引数がこの落とし穴の直しのすべてです。

七つ目は、離したあとの状態の初期化を毎フレーム許してしまうことです。01の新しい表示のリセットはドラッグの区間(t < 1750ms)だけで動きます — 発射のあとのフレームでリセットすると完了の表示が保たれず、測定で「新規0件」に落ちます。完了の状態を消すのは、次の周期の最初のドラッグでなければなりません。

値を変えた差

三つの変形は、それぞれ定数をひとつだけ変えた前後を矢印キーで直接見られます。

名前 変えた値 感触
発射閾値を調整する 01 FIRE_THRESHOLD_PX 70 → 110 表示の基準でより深いドラッグを要求します — 生130pxのドラッグの表示は ≈73px なので110に届かず、以前は発射していたドラッグが発射しなくなります。確信のある更新と偶然の発射の分かれ道がこのひとつの値です
弾性飽和比率を調整する 02 ELASTIC_SATURATE 0.5 → 0.25 生130pxの表示が72.7pxから47.3pxへ減ってゴムのように張り、閾値70pxへの到達には生で約222pxが要るようになります — 同じ閾値でも、飽和比率が変わると指が下がるべき距離が三倍近く変わります
復帰スプリング減衰を調整する 04 RETURN_DAMPING 0.82 → 0.55 減衰の係数を下げると跳ねが増えて落ち着くまでが長くなり、物理的な輪ゴムのように静まります — 一度に巻き戻る速い復帰と、伸びて静まる復帰の差がこの値です

九つの場面のソースとreact版をひとつのzipにして、下の箱から受け取れます。開く暗証番号は una94pe4 です。閾値の判定・弾性の変換・スプリングの積分がそれぞれ何行で書けるかは、コードを開いて確かめてください。

アクセシビリティ — 引っ張りは補助手段で、ボタンと文が本流です

引っ張って更新は、指がないと使えない入力なので、代替の経路が本流です。08の更新ボタンは実際の <button> に「今すぐ更新」の aria-label を付けて、Enter・Space のキー操作でも発射され、prefers-reduced-motion がオンでもすぐ実行されます — 動きを減らす設定が機能まで消してはいけないからです。

09の切替もボタンの aria-pressed でオン・オフを伝えます。

状態の知らせは音にも届きます。05・06の完了の案内は role="status" の文が完了の文だけを書き換え、進行の状態行は aria-live を切って毎フレームの数字が読み上げられないようにしています。場面ごとに aria-label で核心の文を付けて、絵だけでは伝わらない判定の中身を文に残します。

prefers-reduced-motion がオンになると、九つの場面はすべてループを回さずに完了の状態を一枚だけ描きます — 判定の結果はそのまま見せて、過程の動きだけを減らすのが原則です。

caniuse の数値は2026-11-17に直接確認しました。Pointer Events API は全体の97.49% · Chrome 55+ · Safari 13+(iOS 13.2+)、prefers-reduced-motion は Chrome 74+ · Firefox 63+ · Safari 10.1+ で、このデモの判定の計算そのものはフォールバックなしにすべてのブラウザーで動く純粋な算術です。

自分のコードに貼るときの最小の防御は下の数行です。

@media (prefers-reduced-motion: reduce) {
  .pull-pad { transition: none; }
  .pull-indicator { animation: none; }
}

続きは、引っ張って更新のローディングUIパターン・スクロール慣性の物理パターン・リストをスワイプでめくるページネーションの三つです。

出典: MDN Touch events · MDN overscroll-behavior · MDN Pointer events

MDN の touch-action

引っ張って更新を作りながらよくある質問 — Chrome標準と重なる / デスクトップで動く / 閾値はいくつ

引っ張って更新 無効 にするにはどうすればいいですか

コンテナに overscroll-behavior-y: contain を与えるとChrome標準の引っ張りが止まり、自分の判定だけが残ります。さらに scrollTop === 0 の検査を一緒に置いて、リストの途中のドラッグと重ならないようにします。

Safari 15以前は contain が効かないので touchmove の preventDefault の補助が要ります — 本文の壊れる瞬間のひとつ目と三つ目がこの件のすべてです。

デスクトップのブラウザーでも引っ張って更新は動きますか

動きます。ポインターイベントで受けると、マウスのドラッグがタッチと同じコードを通るので、閾値と弾性の計算がそのまま再利用されます。ただしマウスでの縦ドラッグは不自然な操作なので、08の場面のように更新ボタンを一緒に出すのが正解で、そのボタンがキーボードの利用者にとって唯一の経路でもあります。

閾値はいくつにするのがいいですか

このデモは表示距離の基準で70pxに取りました — 親指の関節ひとつぶんで、偶然のドラッグでは届かない線です。下げると軽く発射しますが誤動作が増え、上げると確信のある更新になります。

ただし70pxを生の距離の基準と勘違いしないことです — 弾性変換のあとの表示距離の基準なので、生では約125pxを引くことになり、更新が終わったことを知らせる表示(チェック・案内の文)も閾値と一緒に決めておくのが順番です。

解凍パスワードを入力してください

パスワードはこの記事の本文の中にあります。読み進めると出てきます。