Communitygithub.com

brainzcode/premium-landing

プレミアムモバイルメニューを構築します。ハンバーガーボタンが閉じるXに変形し、全画面オーバーレイパネルでリンクが段階的に表示され、スクロールロック、フォーカストラップ、モーション軽減に対応します。

premium-landing とは?

このスキルは、ハンバーガーボタンがXにモーフィングし、リンクが段階的に表示される全画面オーバーレイパネルを備えた、プロフェッショナルなモバイルメニューを提供します。主な機能として、単一の `set(state)` 関数によるすべての状態管理(クラス、aria-expanded、inert、スクロールロックを含む)、ヘッダーがパネルより高いz-indexを持つことによる閉じるボタンのトラップ防止、iOSのラバーバンドスクロールを防ぐボディ固定、`visibility` と遅延トランジションによるキーボードセーフなパネル、`prefers-reduced-motion` への対応などが含まれます。対応プラットフォームは、Claude Code、Cursor、Codexなど、あらゆるAIエージェントまたは開発環境です。このスキルのSKILL.mdドキュメントに基づき、UXの落とし穴(z-indexの競合、iOSのスクロール問題、フォーカス管理の失敗など)を回避するための実践的なアドバイスと、プレミアム感を高めるための具体的なテクニック(イージング、タイミング、タイポグラフィなど)を提供します。

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

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

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

ドキュメント

プレミアムモバイルメニュー

モバイルメニューは、1つのブール値に連動する4つの要素で構成されます。変形するボタン、表示されるパネル、背後で固定されたページ、そして内部に閉じ込められたフォーカスです。ほとんどすべての壊れたメニューは、これら4つの同期が取れなくなった結果です。つまり、どこか別の場所で、何か別のものによって、いずれかが切り替えられています。

すべてを単一の set(state) 関数で駆動してください。 クリックハンドラ全体に classList.toggle() を散らばらせたり、スクロールロックを忘れた別の「閉じる」パスを用意したりしないでください。1つの関数で、すべての属性を、両方向に処理します。

構造

ヘッダーはパネルよりも上位にあり、パネルは他のすべてを覆います。

.nav  { position: fixed; inset: 0 0 auto; z-index: 210 }  /* バーガーはここ */
.menu { position: fixed; inset: 0 0 auto; z-index: 200; height: 100dvh }
<header class="nav">
  <a class="brand" href="/">silva</a>
  <button class="burger" id="menuBtn" type="button"
          aria-label="メニューを開く" aria-expanded="false" aria-controls="menu">
    <i></i><i></i>
  </button>
</header>

<div class="menu" id="menu" role="dialog" aria-label="メニュー" tabindex="-1" inert>
  <nav class="menu__nav">
    <a href="#about"><span class="menu__idx">01</span> 会社概要</a>
    <a href="#work"><span class="menu__idx">02</span> 実績</a>
  </nav>
  <div class="menu__foot">…</div>
</div>

バーガーはヘッダー内に留まり、その場で変形します。これは開くコントロールであると同時に閉じるコントロールでもあり、そのためヘッダーがパネルの上に位置する必要があります(トラップ1を参照)。

ボタン

44×44 のターゲットサイズ、表示バーのサイズは22pxです。バーは絶対配置され、トランスフォームではなくマージンで中央揃えされます。これにより、transform プロパティは変形のために自由に使えます。

.burger {
  position: relative; display: grid; place-items: center;
  width: 44px; height: 44px;
  background: none; border: 0; padding: 0; cursor: pointer;
  color: currentColor;
  -webkit-tap-highlight-color: transparent;
}

.burger i {
  position: absolute; left: 50%; top: 50%;
  margin: -.75px 0 0 -11px;          /* 中央揃えはここにあり、transformではありません */
  width: 22px; height: 1.5px;
  background: currentColor; border-radius: 2px;
  transition: transform .45s var(--ease);
}

.burger i:first-child { transform: translateY(-4px) }
.burger i:last-child  { transform: translateY(4px)  }

html.is-menu-open .burger i:first-child { transform: rotate(45deg)  }
html.is-menu-open .burger i:last-child  { transform: rotate(-45deg) }

両方のバーは1つの中心点を共有しているため、±45°回転させるだけで、2つ目のキーフレームや調整の必要なく、対称的なXが形成されます。代わりに translate(-50%,-50%) で中央揃えすると、すべての変形状態でそのトランスレートを再指定する必要があり、2つのバーが1ピクセルずれてしまいます。

バーは3本ではなく2本使用してください。 3本バーのXでは、中央のバーをフェードアウトさせながら外側の2本を収束させる必要があり、そのフェードがトランジション中に灰色のスミアとして視認されます。2本のバーはきれいに変形します。もし3本バーの静止状態がどうしても必要な場合は、外側のバーを translateY + rotate でアニメーションさせ、中央のバーの opacity には回転が始まる前にフェードアウトが完了するようより短い duration を設定してください。

バーを動かすために top/margin をアニメーションさせないでください。Transformのみを使用します。

パネル

.menu {
  position: fixed; left: 0; right: 0; top: 0;
  height: 100dvh;                      /* inset:0 ではない — トラップ2を参照 */
  z-index: 200;
  display: flex; flex-direction: column; justify-content: space-between;
  padding: clamp(96px, 24vw, 150px) var(--gutter)
           max(clamp(28px, 7vw, 52px), env(safe-area-inset-bottom));
  background: var(--black); color: var(--white);
  overflow-y: auto; overscroll-behavior: contain;

  opacity: 0; visibility: hidden; transform: translateY(-12px);
  transition: opacity .45s var(--ease),
              transform .55s var(--ease),
              visibility 0s linear .45s;   /* フェードが完了してから非表示にする */
}

.menu.is-open {
  opacity: 1; visibility: visible; transform: none;
  transition-delay: 0s;                    /* 開くときはvisibilityの遅延をキャンセル */
}

visibility はこれをキーボードセーフにするものです。opacity: 0 だけではできない、閉じたパネルをタブオーダーから削除します。遅延された visibility トランジションが全体のトリックです。開くときは即座に表示され、閉じるときはフェードアウトが再生された後にのみ非表示になります。

リンクの段階的な表示は、高コストに見える部分です。

.menu__nav a {
  opacity: 0; transform: translateY(18px);
  transition: opacity .6s var(--ease), transform .6s var(--ease);
}
.menu.is-open .menu__nav a { opacity: 1; transform: none }

.menu.is-open .menu__nav a:nth-child(1) { transition-delay: .10s }
.menu.is-open .menu__nav a:nth-child(2) { transition-delay: .16s }
.menu.is-open .menu__nav a:nth-child(3) { transition-delay: .22s }
.menu.is-open .menu__nav a:nth-child(4) { transition-delay: .28s }
.menu.is-open .menu__nav a:nth-child(5) { transition-delay: .34s }

60ms間隔です。約40ms未満では1つのブロックとして認識され、約90msを超えると最後のアイテムが遅く感じられます。長さが不明なリストの場合は、各アイテムに style="--i:3" を設定し、transition-delay: calc(.10s + var(--i) * .06s) を使用します。

閉じる際には、遅延を削除します(.menu:not(.is-open) .menu__nav a { transition-delay: 0s })。段階的な終了は閉じる動作を遅く感じさせるため、閉じるのは即座に行うべきです。

状態関数

(function () {
  var btn   = document.getElementById('menuBtn');
  var panel = document.getElementById('menu');
  var root  = document.documentElement;
  var open  = false;
  var scrollY = 0;

  var FOCUSABLE = 'a[href], button:not([disabled]), input, select, textarea,' +
                  '[tabindex]:not([tabindex="-1"])';

  // バーガーは閉じるコントロールでありパネルの外側にあるため、サイクルに含める必要がある
  function focusables() {
    return [btn].concat([].slice.call(panel.querySelectorAll(FOCUSABLE)));
  }

  function set(state) {
    if (state === open) return;
    open = state;

    panel.classList.toggle('is-open', open);
    root.classList.toggle('is-menu-open', open);
    btn.setAttribute('aria-expanded', String(open));
    btn.setAttribute('aria-label', open ? 'メニューを閉じる' : 'メニューを開く');
    if (open) panel.removeAttribute('inert');
    else      panel.setAttribute('inert', '');

    if (open) {
      scrollY = window.scrollY;
      document.body.style.position = 'fixed';
      document.body.style.top = -scrollY + 'px';
      document.body.style.left = '0';
      document.body.style.right = '0';
      panel.focus({ preventScroll: true });
    } else {
      document.body.style.position = '';
      document.body.style.top = '';
      document.body.style.left = '';
      document.body.style.right = '';
      window.scrollTo(0, scrollY);
      btn.focus({ preventScroll: true });
    }
  }

  btn.addEventListener('click', function () { set(!open); });

  panel.querySelectorAll('a').forEach(function (a) {
    a.addEventListener('click', function () { set(false); });
  });

  document.addEventListener('keydown', function (e) {
    if (!open) return;
    if (e.key === 'Escape') { set(false); return; }
    if (e.key !== 'Tab') return;

    var list  = focusables();
    var first = list[0];
    var last  = list[list.length - 1];
    if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
    else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
  });

  // ブレークポイントをまたぐと、ページがロックされた状態で取り残されてはならない
  matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
    if (e.matches) set(false);
  });
})();

ここでは inert が aria-hidden の代わりに使用されています。フォーカスを保持できるパネルに aria-hidden="true" を決して設定しないでください。もしフォーカスがその内部にある場合、フォーカスされた要素がアクセシビリティツリーから隠されてしまい、スクリーンリーダーが適切に処理できない作成エラーになります。inert は1つの属性でフォーカスをブロックし、ツリーから隠します。

role="dialog" であり、aria-modal="true" ではないことに注意してください。aria-modal は支援技術にダイアログ外のすべてを無視するよう指示しますが、閉じるボタンはその外側にあります。aria-modal を削除するか(上記のように)、パネル内に実際の閉じるボタンを配置してください。

トラップ1 — ヘッダーはパネルよりも上位にある必要がある

バーガーはXに変形するため、パネルが開いている間もクリック可能である必要があります。パネルの z-index がヘッダーよりも高い場合、Xはレンダリングされますが(ヘッダー内で描画されます)、すべてのクリックはオーバーレイに吸収されます。メニューは目に見える脱出手段のない罠となり、「閉じるボタンが機能しない」と報告されます。

ヘッダーにパネルより高い z-index を与え、ページ上の他のすべての固定レイヤー(CookieバーやスティッキーCTAが通常の衝突箇所です)に対して両方を確認してください。動作する設定例: パネル 200、ヘッダー 210、トースト 9000。

固定要素は、同じ重ね合わせコンテキストを共有している場合にのみ互いにスタックします。任意の祖先に対する transform、filter、opacity < 1、または will-change は新しいコンテキストを作成し、比較全体を静かに再配置します。

トラップ2 — body への overflow: hidden はiOSでは機能しない

document.body.style.overflow = 'hidden' はデスクトップブラウザでは機能しますが、iOS Safariでのタッチドラッグには何の効果もありません。ページはパネルの背後でラバーバンドし、解放されるとユーザーはまったく別の場所に移動してしまいます。

機能するロックは、bodyを固定しオフセットを復元することです。これは上記の set() が行っていることです。それに付随する2つの詳細:

  • パネル上の overscroll-behavior: contain は、パネル自体のスクロールが端に達したときにページに連鎖するのを防ぎます。
  • bodyの固定を解除する同じ呼び出しで window.scrollTo(0, scrollY) を使用して復元します。bodyの固定が解除された後に scrollY を読み取ると0になります。

ヘッダーが position: sticky で fixed ではない場合、このロックはそれを破壊します。 固定されたbodyにはスクロールポートがないため、stickyはドキュメントに対して解決され、ヘッダーはページの一番上にジャンプし、バーガーもろとも画面外に消えます。メニューが開いている間は fixed に切り替えてください(html.is-menu-open .nav { position: fixed; top: 0 })。lenis-smooth-scroll スキルはLenis側から同じ問題をカバーしています。そのライブラリがページ上にある場合は、2つ目のロックの代わりに lenis.stop() を使用し、両方を重ねないでください。

ゼロではないスクロールオフセットでロックをテストしてください。スクロール0では、壊れたロックも動作するロックもピクセル単位で同一に見えます。約1200までスクロールし、開き、ドラッグし、閉じます。位置が全体を通して1200を読み取る必要があります。

トラップ3 — display: none はトランジションできない

display をトグルするとアニメーションが完全にスキップされます。パネルはパッと表示され、パッと消えます。上記の visibility + 遅延トランジションのパターンは、どこでも機能するバージョンです。

2024年以降のベースラインを必要としても構わない場合のモダンな同等物:

.menu { display: none; opacity: 0;
        transition: opacity .45s var(--ease), display .45s allow-discrete }
.menu.is-open { display: flex; opacity: 1 }
@starting-style { .menu.is-open { opacity: 0 } }

@starting-style は必須です。これがないと、エントリーに開始値がなく、終了アニメーションのみが実行されます。

トラップ4 — パネルは背景ブラーに適した場所ではない

全画面パネルでの backdrop-filter は、すべてのフレームで背後にあるすべてを再サンプリングし、ミッドレンジのAndroidではエントランスアニメーションが一桁のfpsに低下します。とあるビルドでは、全画面のブレンド/ブラーを削除したところ、ドロップフレームが34%から3%に減少しました。

プレミアムメニューはほとんどの場合、すりガラスではなく不透明なブランドカラーのパネルです。デザインがガラスを求める場合は、画面の一部を覆うシートなど小さな要素にブラーをかけ、ビューポート全体には決してかけないでください。liquid-glass スキルも参照してください。

トラップ5 — 誰もテストしない状態

  • 開いたままブレークポイントをまたいでリサイズする。 上記の matchMedia で処理されています。resize リスナーではなく、ドラッグのすべてのフレームではなく、またぐときに1回だけ発火します。
  • クライアントサイドのルート変更。 Next/Astro/SPAナビゲーションでは、パネルはナビゲーション後も存続します。ルーターイベントで set(false) を呼び出し、アンマウント時にbodyのスタイルをクリーンアップします。
  • 開いた後の戻るボタン。 メニューが開いたときにヒストリーエントリをプッシュした場合、戻るボタンはページを離れるのではなく、メニューを閉じる必要があります。
  • 200%にズームする。 パネルはフッターをクリップするのではなく、スクロールできる必要があります。
  • 横向きの電話。 スクロール可能なパネルを備えた 100dvh で処理します。垂直方向に中央揃えされた justify-content: center のリストでは処理できません。

モーション軽減

@media (prefers-reduced-motion: reduce) {
  .menu, .menu__nav a, .burger i {
    transition-duration: .01ms !important;
    transition-delay: 0s !important;
  }
}

状態の変更は維持し、演出を削除します。パネルは表示/非表示を行う必要があります。

プレミアムと見なされる要素

上記のメカニズムは当然の前提です。以下は、ブートストラップのドロワーと差別化する選択肢です。

  • イージング。 パネルとリンクには cubic-bezier(.16, 1, .3, 1)(expo-out)。速い開始、長い停止。ease や linear は避けてください。
  • タイミング。 パネル 450–600ms、リンクは60ms間隔で600ms、バーガーの変形は450ms。300ms未満では動きとして認識されず、700msを超えると緩慢に感じられます。
  • タイポグラフィ。 リンクリスト自体がデザインです。clamp(1.65rem, 8.4vw, 2.9rem)、表示ウェイト300、line-height: 1、大文字、字間を詰める。行間のヘアラインルール。
  • インデックス番号。 各ラベルの前に小さなモノスペースまたは文字間隔を空けた大文字で 01 / 02 / 03 を配置し、落ち着いたトーンで設定します。追加コストは低く、どのエフェクトよりも知覚品質に貢献します。
  • 行全体のヒットエリア。 アンカー自体に clamp(14px, 3.4vw, 22px) の垂直パディングを設定し、その周りにマージンでスペースを取らないでください。行全体がタップ可能になります。
  • :active 状態であり、:hover 状態ではないこと。 スマートフォンにはホバーがなく、タップ後に残るホバースタイルは壊れて見えます。
  • フッターブロック — 連絡先、ソーシャル、単一のピルCTA — を justify-content: space-between で固定します。下部の空きスペースは、メニューをプレースホルダーのように感じさせます。
  • パネル自体にバウンスやスプリングがないこと。 全画面サーフェスでのオーバーシュートは安っぽく見えます。スプリングイージングは小さな要素のために取っておいてください。

チェックリスト

  • 単一の set(state) 関数がクラス、aria-expanded、ラベル、inert、スクロールロックを所有している
  • ヘッダーの z-index がパネルのものより上であり、他のすべての固定要素に対して確認済み

…

[翻訳のために省略]

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

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

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

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.

関連スキル