Communitygithub.com

brainzcode/premium-landing

Lenisのスムーズスクロールをサイトに正しく導入するためのスキルです。セットアップ、スティッキーヘッダー用のアンカーオフセット、モーダルやメニュー用のスクロールロック、動作軽減設定の処理をカバーします。スムーズスクロール、Lenis、モメンタム/イージングスクロールが依頼されたとき、またはスムーズスクロールがスティッキーヘッダー、モーダルロック、アンカーリンクを壊したときに使用します。スクロールがゼロでないときのみ発生するスティッキーポジションの落とし穴を含みます。

premium-landing とは?

このスキルは、Lenisを使用したスムーズスクロールをWebサイトに実装するための包括的なガイドです。Lenisはネイティブのスクロール位置をイージングで制御するライブラリで、`position: sticky`や`IntersectionObserver`、`window.scrollY`と互換性があるため、他のスムーズスクロール手法よりも推奨されます。スキルでは、CDNではなくベンダーファイルとしてのセットアップ方法、必須のCSS、さらに`overflow: clip`によるスティッキーヘッダーの破損、二重スクロールロック、アンカーリンクのジャンプ、パフォーマンス問題といった4つの主要な落とし穴とその修正方法を詳細に説明しています。また、`prefers-reduced-motion`への対応やフレームタイミング測定用のハーネスも含まれており、実用的なチェックリストが完備されています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントがスムーズスクロールの実装やトラブルシューティングを依頼された際に、正確で堅牢なコードを生成するために設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/lenis-smooth-scroll

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 をスキップし、ネイティブの動作を復元する
  • スクロール位置が開く → 閉じるの間で保持される
  • フレームタイミングが推測ではなく測定されている

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

関連スキル