Communitygithub.com

brainzcode/premium-landing

Construisez une navigation mobile premium : un bouton hamburger qui se transforme en croix de fermeture, un panneau en superposition plein écran avec dévoilement échelonné des liens, verrouillage du défilement, piège de focus et gestion du mouvement réduit.

Qu'est-ce que premium-landing ?

Ce skill fournit une solution complète et robuste pour créer un menu mobile premium, en évitant les pièges courants qui rendent les menus cassés. Il est basé sur une fonction `set(state)` unique qui centralise tous les changements d'état (bouton, panneau, verrouillage du défilement, focus) pour garantir la synchronisation. Le skill détaille la structure HTML/CSS nécessaire (avec un `z-index` du header supérieur à celui du panneau pour éviter le piège du bouton de fermeture), le morphe du bouton hamburger en X (utilisant deux barres pour une animation propre), l'animation du panneau (avec `visibility` pour l'accessibilité clavier), le dévoilement échelonné des liens, le verrouillage du défilement spécifique à iOS (en fixant la position du body), et la gestion du focus avec `Tab`. Il aborde également les cas aux limites (redimensionnement, zoom, changement de route, bouton retour) et les optimisations de performance (éviter les fondus sur tout l'écran). Il supporte les plateformes web modernes et est conçu pour des agents comme Claude Code, Cursor ou Codex qui génèrent du code front-end.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Menu mobile premium

Un menu mobile est constitué de quatre éléments reliés à un seul booléen : un bouton qui se transforme, un panneau qui se dévoile, la page derrière qui reste figée, et le focus qui reste à l'intérieur. Presque tous les menus cassés le sont parce que ces quatre éléments se désynchronisent — l'un d'eux est basculé ailleurs, par autre chose.

Pilotez tout cela à partir d'une seule fonction set(state). Pas de classList.toggle() dispersé dans des gestionnaires de clic, pas de chemin de "fermeture" séparé qui oublie le verrouillage du défilement. Une seule fonction, chaque attribut, dans les deux sens.

Structure

L'en-tête surpasse le panneau, et le panneau recouvre tout le reste :

.nav  { position: fixed; inset: 0 0 auto; z-index: 210 }  /* le burger vit ici */
.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="Ouvrir le menu" aria-expanded="false" aria-controls="menu">
    <i></i><i></i>
  </button>
</header>

<div class="menu" id="menu" role="dialog" aria-label="Menu" tabindex="-1" inert>
  <nav class="menu__nav">
    <a href="#about"><span class="menu__idx">01</span> À propos</a>
    <a href="#work"><span class="menu__idx">02</span> Travail</a>
  </nav>
  <div class="menu__foot">…</div>
</div>

Le burger reste dans l'en-tête et se transforme sur place. Il est à la fois la commande d'ouverture et la commande de fermeture, c'est pourquoi l'en-tête doit se situer au-dessus du panneau — voir Piège 1.

Le bouton

Cible 44×44, barre visible de 22px. Les barres sont positionnées en absolu et centrées avec des marges, pas des transformations, donc la propriété transform reste libre pour la transformation :

.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;          /* le centrage vit ici, pas dans 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) }

Les deux barres partagent un seul point central, donc les faire pivoter de ±45° donne une croix symétrique sans deuxième image clé et sans rien à ajuster. Si vous centrez avec translate(-50%,-50%) à la place, chaque état de transformation doit répéter ce décalage et les deux barres s'écartent d'un pixel.

Utilisez deux barres, pas trois. La croix à trois barres nécessite que celle du milieu s'estompe pendant que les deux extérieures convergent, et l'estompage est visible comme une traînée grise au milieu de la transition. Deux barres se transforment proprement. Si un état de repos à trois barres est non négociable, animez les barres extérieures avec translateY + rotate et donnez à l'opacité du milieu une durée plus courte pour qu'elle disparaisse avant le début de la rotation.

N'animez jamais top/margin pour déplacer les barres. Transform uniquement.

Le panneau

.menu {
  position: fixed; left: 0; right: 0; top: 0;
  height: 100dvh;                      /* pas inset:0 — voir Piège 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;   /* cacher seulement après la fin de la disparition */
}

.menu.is-open {
  opacity: 1; visibility: visible; transform: none;
  transition-delay: 0s;                    /* annuler le délai de visibilité à l'entrée */
}

visibility est ce qui rend ceci sûr pour le clavier : cela retire le panneau fermé de l'ordre de tabulation, ce que opacity: 0 seule ne fait pas. La transition retardée de visibility est toute l'astuce — visible immédiatement à l'ouverture, caché seulement une fois que la disparition a été jouée.

Le dévoilement échelonné des liens est ce qui donne l'impression d'être coûteux :

.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 d'écart. En dessous de ~40ms, cela se lit comme un bloc ; au-dessus de ~90ms, le dernier élément semble tardif. Pour une liste de longueur inconnue, mettez style="--i:3" sur chaque élément et utilisez transition-delay: calc(.10s + var(--i) * .06s).

À la sortie, supprimez les délais (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Une sortie échelonnée donne l'impression que la fermeture est lente — la fermeture doit être immédiate.

La fonction d'état

(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"])';

  // le burger est la commande de fermeture et vit en dehors du panneau, donc il fait partie du cycle
  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 ? 'Fermer le menu' : 'Ouvrir le menu');
    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(); }
  });

  // franchir le point de rupture ne doit pas laisser la page dans un état verrouillé
  matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
    if (e.matches) set(false);
  });
})();

inert remplace aria-hidden ici. Ne mettez jamais aria-hidden="true" sur un panneau qui peut contenir le focus — si le focus est à l'intérieur, vous avez caché l'élément focalisé de l'arbre d'accessibilité, ce qui est une erreur de codage mal gérée par les lecteurs d'écran. inert bloque le focus et cache de l'arbre en un seul attribut.

Notez le role="dialog" sans aria-modal="true". aria-modal dit aux technologies d'assistance d'ignorer tout ce qui se trouve en dehors de la boîte de dialogue, et le bouton de fermeture est en dehors. Soit supprimez aria-modal (comme ci-dessus), soit mettez un vrai bouton de fermeture à l'intérieur du panneau.

Piège 1 — l'en-tête doit surpasser le panneau

Le burger se transforme en X, il doit donc rester cliquable pendant que le panneau est affiché. Si le z-index du panneau est plus élevé que celui de l'en-tête, le X s'affiche (il est peint dans l'en-tête) mais chaque clic atterrit sur la superposition. Le menu devient un piège sans issue visible — signalé comme "le bouton de fermeture ne fait rien".

Donnez à l'en-tête un z-index plus élevé que celui du panneau et vérifiez les deux par rapport à chaque autre couche fixe sur la page (les barres de cookies et les CTA collants sont les collisions habituelles). Un ensemble fonctionnel : panneau 200, en-tête 210, toasts 9000.

Les éléments fixes ne s'empilent que lorsqu'ils partagent un contexte d'empilement. Un transform, filter, opacity < 1, ou will-change sur un ancêtre quelconque en crée un nouveau et re-parente silencieusement toute la comparaison.

Piège 2 — overflow: hidden sur le body ne tient pas sur iOS

document.body.style.overflow = 'hidden' verrouille les navigateurs de bureau et ne fait rien à un glissement tactile sur iOS Safari. La page rebondit derrière le panneau, et au relâchement, l'utilisateur se retrouve ailleurs.

Le verrouillage qui fonctionne consiste à épingler le body et à restaurer le décalage, ce que fait set() ci-dessus. Deux détails qui l'accompagnent :

  • overscroll-behavior: contain sur le panneau empêche le défilement propre du panneau de se propager à la page lorsqu'il atteint une extrémité.
  • Restaurez avec window.scrollTo(0, scrollY) dans le même appel qui efface la position. Lire scrollY après que le body soit désépinglé donne 0.

Si votre en-tête est position: sticky plutôt que fixed, ce verrouillage le casse. Un body épinglé n'a pas de port de défilement, donc sticky se résout par rapport au document et l'en-tête saute en haut de la page — hors écran, emportant le burger avec lui. Basculez-le en fixed pendant que le menu est ouvert (html.is-menu-open .nav { position: fixed; top: 0 }). Le skill lenis-smooth-scroll couvre la même défaillance du côté de Lenis ; si cette bibliothèque est sur la page, utilisez lenis.stop() au lieu d'un second verrouillage plutôt que d'empiler les deux.

Testez le verrouillage à un décalage de défilement non nul. Au défilement 0, un verrouillage cassé est pixel-identique à un verrouillage fonctionnel. Faites défiler jusqu'à ~1200, ouvrez, faites glisser, fermez : la position doit lire 1200 tout au long.

Piège 3 — display: none ne peut pas être transitionné

Basculer display saute complètement l'animation : le panneau apparaît et disparaît brusquement. Le motif visibility + transition retardée ci-dessus est la version qui fonctionne partout.

L'équivalent moderne, si vous êtes prêt à exiger une base de 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 est requis — sans lui, l'entrée n'a pas de valeur de départ et seule la sortie s'anime.

Piège 4 — le panneau n'est pas le bon endroit pour un flou d'arrière-plan

backdrop-filter sur un panneau plein écran rééchantillonne tout ce qui se trouve derrière à chaque image, et sur les Android de milieu de gamme, il fait chuter l'animation d'entrée à quelques images par seconde. Sur une version, la suppression d'un mélange/flou plein écran a fait passer les images perdues de 34 % à 3 %.

Un menu premium est presque toujours un panneau opaque aux couleurs de la marque, pas du verre dépoli. Si le design appelle du verre, floutez un petit élément (une feuille qui couvre une partie de l'écran), jamais la totalité du viewport, et consultez le skill liquid-glass.

Piège 5 — les états que personne ne teste

  • Redimensionnement au-delà du point de rupture alors qu'il est ouvert. Géré ci-dessus avec matchMedia, pas un écouteur resize, donc il se déclenche une fois au passage au lieu de chaque image d'un glissement.
  • Changement de route côté client. Dans la navigation Next/Astro/SPA, le panneau survit à la navigation. Appelez set(false) sur l'événement du routeur et nettoyez les styles du body au démontage.
  • Bouton retour après ouverture. Si vous poussez une entrée d'historique lorsque le menu s'ouvre, le bouton retour doit le fermer plutôt que de quitter la page.
  • Zoom à 200 %. Le panneau doit défiler plutôt que de couper son pied de page.
  • Téléphone en paysage. 100dvh avec un panneau défilant gère cela ; une liste justify-content: center centrée verticalement ne le fait pas.

Mouvement réduit

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

Conservez les changements d'état, supprimez la chorégraphie. Le panneau doit toujours apparaître et disparaître.

Ce qui le fait paraître premium

Les mécanismes ci-dessus sont la base. Ce sont les choix qui le distinguent d'un tiroir bootstrap :

  • Easing. cubic-bezier(.16, 1, .3, 1) (expo-out) sur le panneau et les liens. Départ rapide, installation longue. Jamais ease ou linear.
  • Temporisation. Panneau 450–600ms, liens 600ms avec un échelonnement de 60ms, transformation du burger 450ms. En dessous de 300ms, rien n'est perçu comme un mouvement ; au-dessus de 700ms, cela semble lent.
  • Typographie. La liste de liens est le design. clamp(1.65rem, 8.4vw, 2.9rem), graissage 300, line-height: 1, majuscules, espacement serré. Règles fines entre les rangées.
  • Chiffres d'index. 01 / 02 / 03 en petites lettres mono ou espacées avant chaque étiquette, définies dans un ton atténué. Peu coûteux à ajouter, fait plus pour la qualité perçue que n'importe quel effet.
  • Zones de clic sur toute la rangée. Remplissage vertical de clamp(14px, 3.4vw, 22px) sur le lien lui-même, pas une marge autour, afin que toute la rangée soit tapable.
  • Un état :active, pas un état :hover. Les téléphones ne survolent pas, et un style de survol qui reste après un tapotement semble cassé.
  • Un bloc de pied de page — ligne de contact, réseaux sociaux, un seul CTA pilule — épinglé par justify-content: space-between. L'espace vide en bas est ce qui donne à un menu l'impression d'un espace réservé.
  • Pas de rebond ou de ressort sur le panneau lui-même. Un dépassement sur une surface plein écran semble bon marché. Réservez le ressort pour les petits éléments.

Liste de vérification

  • Une seule fonction set(state) possède la classe, aria-expanded, l'étiquette, inert et le verrouillage du défilement
  • Le z-index de l'en-tête est supérieur à celui du panneau, vérifié par rapport à tous les autres fixes
  • Le panneau utilise visibility: hidden avec une transition retardée pour l'accessibilité clavier
  • Le bouton utilise translateY + rotate, pas translate(-50%, -50%)
  • Les barres du burger mesurent 22×1,5 px, centrées avec des marges
  • Le verrouillage iOS utilise position: fixed sur le body, pas overflow: hidden
  • Le comportement de défilement est testé à un décalage non nul (par exemple, 1200 px)
  • overscroll-behavior: contain sur le panneau
  • Piège de focus Tab : boucle premier ⇄ dernier, Escape ferme
  • inert plutôt que aria-hidden sur le panneau fermé
  • Pas de aria-modal (le bouton de fermeture est en dehors)
  • Liens de navigation : set(false) au clic
  • Échelonnement des liens : 60 ms d'écart, délais supprimés à la sortie
  • matchMedia efface l'état au redimensionnement au-dessus du point de rupture
  • @media (prefers-reduced-motion: reduce) réduit à 0,01 ms
  • 100dvh, pas 100vh, pour la hauteur du panneau
  • Liens de navigation avec zones de clic sur toute la rangée
  • La largeur du panneau remplit tout l'écran (panel inset: 0 ou left: 0; right: 0)
  • Aucune propriété de positionnement sur le body après la fermeture
  • Bouton : aria-controls, aria-expanded, aria-label mis à jour par set()
  • -webkit-tap-highlight-color: transparent sur le bouton
  • Aucun conflit de contexte d'empilement avec les ancêtres transform/filter
  • Testé au zoom 200 % et en orientation paysage

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.

Skills associés