Lenis スムーズスクロール
Lenis はホイール入力をインターセプトし、ネイティブの スクロール位置をイージングで制御します。スティッキーポジショニング、IntersectionObserver、window.scrollY はすべて引き続き動作します。これこそが Lenis が正しい選択である理由です。問題が発生するのは、Lenis 自体ではなく、それと競合するものがある場合です。
セットアップ
CDN のホットリンクではなくベンダーファイルとして配置することで、サイトを自己完結型にし、file:// からも動作するようにします。:
curl -sSL -o assets/vendor/lenis.min.js https://unpkg.com/[email protected]/dist/lenis.min.js
dist/lenis.min.js ビルドは globalThis.Lenis を公開する IIFE です。プレーンな <script> で問題なく動作します。(dist/lenis.mjs は ESM であり、プレーンなスクリプトタグでは動作しません。) 自身のスクリプトの前に読み込んでください。
var reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
var lenis = null;
if (!reduced && window.Lenis) {
var navH = parseInt(getComputedStyle(document.documentElement)
.getPropertyValue('--nav-h'), 10) || 0;
lenis = new Lenis({
duration: 1.05,
easing: t => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
smoothWheel: true,
syncTouch: false, // タッチはネイティブのままにする — スムージングするとスマホで遅く感じる
autoRaf: true, // Lenis は独自の RAF ループを実行する; 手動ティッカーは不要
anchors: { offset: -(navH + 10) } // ページ内リンクがスティッキーヘッダーをクリアする
});
} else {
// Lenis なし — ブラウザにデフォルトの動作を戻す
document.documentElement.style.scrollBehavior = reduced ? 'auto' : 'smooth';
}
必須 CSS
html { /* NO scroll-behavior: smooth — Lenis と競合する */ }
html.lenis, html.lenis body { height: auto; }
.lenis:not(.lenis-autoToggle).lenis-stopped { overflow: clip; }
.lenis.lenis-smooth [data-lenis-prevent] { overscroll-behavior: contain; }
.lenis.lenis-smooth iframe { pointer-events: none; }
html の scroll-behavior: smooth は削除する必要があります。そのままにしておくと、アンカージャンプが二重アニメーションし、イージングと競合します。
落とし穴 1 — overflow: clip は position: sticky を無効にする
これが一番時間を費やす原因です。
lenis.stop() は .lenis-stopped クラスを追加し、その CSS が <html> に overflow: clip を設定します。これによりスクロールポートが削除され、position: sticky が付着する場所がなくなります — スティッキー要素はドキュメント内の位置、つまりページの先頭にスナップバックします。
スクロール位置 1200 でメニューを開くと、スティッキーヘッダーは top: -1200 の位置にレンダリングされます。画面外です。閉じるボタンも同様です。ユーザーは「閉じるボタンが消えた」と報告します。
同じ現象は、従来の body { position: fixed } スクロールロックでも、同じ理由(スクロールポートがないため)で発生します。
修正: スクロールがロックされている間、ヘッダーをビューポートに固定します。
html.menu-open .nav-wrap { position: fixed; top: 0; left: 0; right: 0; }
document.documentElement.classList.toggle('menu-open', open);
オーバーレイがまだ不透明な間にクラスを切り替えて、sticky→fixed のレイアウト変更が見えないようにします。Lenis パスと動作軽減パスの両方に適用します。
ゼロ以外のスクロールオフセットでオーバーレイをテストします。 スクロール位置 0 では、壊れたスティッキーヘッダーは正常なものとピクセル単位で同一に見えるため、バグは完全に隠れます。0、約 1200、およびページの深い位置で検証します。
落とし穴 2 — 2 つのスクロールロックを重ねない
body を固定かつ lenis.stop() を呼び出すと、それらは競合します。body の position: fixed はページの高さを collapse し、Lenis は 0 に再同期し、オーバーレイを閉じるとユーザーはページの先頭に戻されます。
Lenis では、stop() とそれ自身の overflow: clip により、body に触れることなくページを保持します。そのため、スクロール位置が失われることはなく、復元する必要もありません。:
if (lenis) {
open ? lenis.stop() : lenis.start();
} else if (open) { // 動作軽減パスのみ
scrollY = window.scrollY;
document.body.style.position = 'fixed';
document.body.style.top = -scrollY + 'px';
document.body.style.width = '100%';
} else if (document.body.style.position === 'fixed') {
document.body.style.position = '';
document.body.style.top = '';
document.body.style.width = '';
window.scrollTo(0, scrollY);
}
確認: 1200 までスクロール → 開く → ホイール → 閉じる。すべてのステップで位置が 1200 を読み取り、その後スクロールが再び機能する必要があります。
落とし穴 3 — アンカーリンク
Lenis はスクロールを所有するため、生の href="#id" ジャンプは正しく見えません。スティッキーヘッダーの高さに等しい負のオフセットを持つ組み込みの anchors オプションを使用するか、クリックを手動で lenis.scrollTo(target, { offset: -navH }) 経由でルーティングします。
ランディング位置を確認します。セクションの先頭はヘッダーの下端と同じかそれより下に配置され、その下に隠れてはいけません。
落とし穴 4 — Lenis は通常、処理落ちの原因ではない
Lenis を追加した後にスクロールが悪くなったと感じた場合は、Lenis を責める前に測定します。あるビルドでは、ネイティブスクロールの測定値の方が実際には悪く (13% のドロップフレーム対 9%)、Lenis は問題なく、実際のコストは他の場所にありました:
- 固定された全画面の
mix-blend-modeオーバーレイ (フィルムグレイン): ブレンドモードを削除するだけで 34% → 3% のドロップフレーム - スティッキー要素の
backdrop-filter。スクロールのすべてのフレームで画面に表示されます - 大きな要素の
backdrop-filter全般 — フレームごとに再サンプリングします
フレームタイミング計測ハーネス
// ページ内
window.__f = []; let l = performance.now();
const t = n => { window.__f.push(n - l); l = n; requestAnimationFrame(t); };
requestAnimationFrame(t);
疑わしいセクション上で実際のホイールイベントで駆動し、次に 平均、p95、および 33ms を超えるフレームの割合 をレポートします。add_style_tag を使用して一度に 1 つのエフェクトを無効にして二分探索します。健全な状態は平均 ~16.7ms で長いフレームが 0% です。長いフレームが ~10% を超えると、目に見えるスタッターが発生します。
チェックリスト
-
scroll-behavior: smoothがhtmlから削除されている - Lenis CSS ブロックが追加されている
-
autoRaf: true(または手動 RAF ループ。両方ではない) -
anchorsオフセットがスティッキーヘッダーの高さと一致している -
syncTouch: falseでスマホがネイティブのモメンタムを維持する - オーバーレイがスクロールをロックしている間、スティッキーヘッダーが固定されている
- 1 つ のスクロールロックメカニズムのみが動作している
- オーバーレイがゼロ以外のスクロールオフセットでテストされている
-
prefers-reduced-motionが Lenis をスキップし、ネイティブの動作を復元する - スクロール位置が開く → 閉じるの間で保持される
- フレームタイミングが推測ではなく測定されている