FrontLaxWeb : parallax et scroll interactif premium
Ce fichier est le "cerveau" : la méthode. Les recettes et les snippets se trouvent dans
plantillas/et sont lus à la demande. Les cheminsplantillas/,references/,Designs/etComponents/sont relatifs au dossier de ce fichier.
Ce que ce skill permet d'accomplir
Transformer une landing page standard en une web-expérience : le scroll et le pointeur deviennent la télécommande d'une animation continue. Indépendant de la marque : il reçoit les couleurs/tokens de chaque projet.
Les 7 effets (le catalogue)
- Smooth scroll (fondation) : Lenis. La base pour que tout semble premium.
- Parallax de couches : arrière-plans lents / avant rapide = profondeur.
- Animation liée au scroll : propriétés attachées au % de scroll.
- Scroll-reveal : entrer/animer en apparaissant dans le viewport.
- Sticky / pin : quelque chose se "colle" tandis que ce qui l'entoure change (stacking cards).
- Micro-interactions du pointeur : tilt 3D, curseur personnalisé, survol.
- Gestes avec ressorts : glisser, déposer, tap : une physique de ressort interruptible plutôt que des transitions CSS à durée fixe. Voir sa propre section ci-dessous.
Gestes et ressorts (fusionné du skill apple-design d'Emil Kowalski, WWDC distillé)
Terrain DISTINCT du scroll/parallax ci-dessus : c'est la physique de toucher et faire glisser quelque chose (un menu, une carte glissante, un modal, un slider). Les principes les plus actionnables pour le web (des 17 originaux ; le résumé se trouve dans references/recetas-y-matriz.md §4bis) :
- Interruptibilité, le plus important des 17 : toute animation doit pouvoir être attrapée et redirigée en pleine transition. Pour tout ce que l'utilisateur peut TOUCHER, utiliser des ressorts (paramètres :
damping/amortissement +response/vitesse), jamais detransitionCSS à durée fixe : un ressort sait toujours animer depuis sa position ACTUELLE, une transition fixe non. - Transfert de vélocité : en relâchant un geste, l'animation continue à la vitesse du doigt (elle ne redémarre pas de zéro), évitant ainsi la "couture" visuelle. Dans Motion :
dragMomentum+ vélocité duPanInfocomme vitesse initiale du ressort. - Rubber-banding : à une limite, une résistance progressive, jamais un arrêt sec.
- Cohérence spatiale : un panneau qui entre par la droite ressort par la droite ; ancrez l'origine (
transform-origin) sur l'élément qui a déclenché la transition. - Matériaux et profondeur : calques translucides flottants (
backdrop-filter: blur()) pour une hiérarchie visuelle, jamais deux surfaces translucides empilées directement. Sans carte graphique, le mode léger leur retire le flou : leur fond semi-transparent doit être lisible seul. - Confirmation croisée (pas une nouvelle recette) : sa règle "Frame-Level Smoothness" est la MÊME que celle que nous avions déjà dans les Fondations NON négociables (seulement
transform/opacity) : deux sources indépendantes arrivent à la même règle, plus de confiance en elle. - Philosophie de fond (les 8 fondamentaux d'Apple) : Objectif, Autonomie, Responsabilité, Familiarité, Flexibilité, Simplicité, Métier, Ravissement (conséquence de la réussite des 7 précédents). C'est un ethos, pas une technique à implémenter : utilisez-le pour justifier des décisions de design ("est-ce que cela a un but ou est-ce du bruit ?"), pas comme une checklist technique.
✅ Tension résolue. Le principe #14 d'Apple (avec prefers-reduced-motion: reduce, remplacer le mouvement par des fondus d'opacité) entrait en conflit direct avec la politique maison ("tout pour tous", ignorer cette préférence). Une troisième voie a gagné : le mouvement ne s'éteint pas, on en réduit l'amplitude. Le principe 14 n'est ni rejeté ni copié : il est incorporé comme le cas extrême du même dial (--motion-gain: 0 produit justement un site web avec seulement des fondus), il n'y a donc pas deux versions de chaque effet à maintenir. Le mécanisme complet se trouve dans "Politique de mouvement maison" (section propre, ci-dessous).
Fondations NON négociables
- Performance : animer UNIQUEMENT
transformetopacity(GPU). Jamaistop/left/width/height/margin. Utiliserwill-changeà bon escient,requestAnimationFrame, et éviter le layout thrashing. - Sans carte graphique, mode léger : tout site web naît avec la détection du rendu logiciel et son mode léger (sans Lenis, sans flous ni mélanges, 3D avec sa version sans 3D). Section propre ci-dessous.
- Politique de mouvement maison : OBLIGATOIRE dans tout projet. Elle a sa propre section juste ici en dessous, car c'est la règle la plus souvent enfreinte par négligence.
POLITIQUE DE MOUVEMENT MAISON (OBLIGATOIRE)
Tout pour tous, avec la bonne amplitude. Personne ne voit un site web mort. Ce qui change selon le visiteur n'est pas SI il y a du mouvement, mais COMBIEN de déplacement. Un seul dial gouverne tout le site web : la variable CSS --motion-gain, placée sur <html> par un script dans le <head>.
| Situation | --motion-gain | Ce que voit le visiteur |
|---|---|---|
| Par défaut | 1 | L'expérience complète. |
Système avec prefers-reduced-motion: reduce | 0.25 | Le même design avec un quart du déplacement : le mouvement se lit comme un accent, pas comme une caméra. |
URL avec ?motion=off | 0 | Tout ce qui bougeait seul reste immobile, et la classe motion est retirée. Ce que le visiteur fait glisser avec le doigt continue de répondre : une carte glissante qui ne glisse pas n'est pas une interface sobre, c'est une photo cassée. C'est la valve pour celui qui ne veut pas de mouvement, pas un mode de design. |
URL avec ?motion=full | 1 forcé | Ignore la préférence du système. Pour vérifier le travail depuis une machine avec les effets d'animation Windows désactivés. |
0.25 est la valeur maison, ajustable par projet si l'effet le demande, mais jamais 1 : si avec reduce rien ne change, vous n'appliquez pas la politique.
Les trois règles du dial
gainmultiplie le déplacement : pixels, échelle, rotation, skew. Pour les effets continus (marquee, boucles), il multiplie la vitesse.gainne multiplie jamais l'opacité. Un fondu ne donne pas le vertige à personne. Ainsi, en baissant le dial, un effet ne se casse pas : il dégrade. La matriochka avecgain: 0.25raconte toujours la même chose, mais sous forme de fondu enchaîné au lieu d'un zoom de caméra. Et c'est pourquoi cette politique n'oblige pas à écrire une deuxième version de chaque effet, ce qui était justement le coût du principe 14.gainne réduit pas le mouvement dirigé par l'utilisateur : glisser, survol, tilt avec le pointeur, curseur lerp, ressorts de geste. L'oreille interne ne proteste pas contre ce qu'on provoque soi-même. Il réduit uniquement le mouvement non sollicité : parallax, zoom au scroll, matriochka, scrubbing de séquence, horizontal, velocity skew, marquee.
Et toujours, en plus
4. Valve visible. En plus de ?motion=off, un contrôle accessible dans l'interface (au moins dans le pied de page). Une valve qui n'existe que dans l'URL n'est pas trouvable par ceux qui en ont besoin.
5. Focus clavier et ancres intacts, et contenu lisible sans JS (progressive enhancement).
Accessibilité, avec rigueur (vérifié contre WCAG, MDN et web.dev, 2026-08-19) :
- Ce qui rend cette politique CONFORME n'est pas le dial, c'est la valve. WCAG 2.3.3 (niveau AAA) exige de pouvoir DÉSACTIVER le mouvement, pas seulement le réduire ;
?motion=offest ce mécanisme, et c'est pourquoi il est obligatoire et découvrable. Un dial qui ne fait que réduire, sans extinction réelle, ne respecterait pas la lettre de 2.3.3. 0.25sousreduceest un POINT DE DÉPART, pas un absolu. Ce qui donne le vertige est le mouvement de grande amplitude (parallax, zoom, translation de grande surface), pas l'opacité ni le petit déplacement. Règle fine : sousreduce, ce grand mouvement doit être ramené à ~zéro ou remplacé par un fondu, pas laissé "plus petit mais présent". Pour un reveal de 16 px,0.25suffit ; pour un parallax de 300 px,0.25donne encore le vertige et il faut descendre plus bas ou passer directement à l'opacité. C'est exactement ce que soutiennent MDN et web.dev : "remove, reduce OR replace".- WCAG 2.2.2 "Pause, Stop, Hide" (niveau A, OBLIGATOIRE, pas AAA) : toute animation automatique en boucle de plus de 5 s (marquee, vidéo de fond, dégradé en mouvement) DOIT avoir un contrôle de pause ou d'arrêt, et le dial ne le remplace PAS. Si vous mettez un marquee infini, il doit avoir son bouton de pause séparé.
Interrupteur central (à copier tel quel dans le <head>, avant tout CSS d'animation) :
<script>
(function () {
var h = document.documentElement;
var q = new URLSearchParams(location.search).get('motion');
var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
h.style.setProperty('--motion-gain', String(gain));
h.classList.toggle('motion', gain > 0); // compatibilité : les états animés dépendent de html.motion
})();
</script>
En CSS, on l'utilise dans calc() ; en JS, on le lit une fois et on multiplie :
const GAIN = parseFloat(getComputedStyle(document.documentElement)
.getPropertyValue('--motion-gain')) || 0;
SANS CARTE GRAPHIQUE : LE MODE LÉGER (inclus dans tout nouveau site web)
Le cas. Sur un ordinateur avec l'accélération matérielle désactivée (cela arrive aussi sur de nombreux vieux ordinateurs ou ordinateurs d'entreprise), trois sites web avec scroll animé avaient des à-coups, tandis que cloudflare.com était fluide. Mesuré avec le CPU 6x et sans carte graphique, à 1920x1080, en comptant ce qui arrive à l'écran :
| Site web | Avant | Avec le mode léger | cloudflare.com, à égalité |
|---|---|---|---|
| SaaS (Lenis, verre, 3D) | 1,7 images/s, blocage de 2,4 s | 27,5 et 0,13 s | 42,6 et 47 ms |
| Portfolio (Lenis, orbes avec flou, 3D) | 4,6 et 372 ms | 24,8 et 84 ms | 45,3 et 49 ms |
| Produit (sans Lenis ; nuages avec flou, grain en overlay, démo de verre) | 30,1 et 260 ms | 42,6 et 74 ms | 46,5 et 46 ms |
Avec une carte graphique, le mode léger ne s'active pas et rien ne change (vérifié pixel par pixel sur les trois).
Pourquoi. Sans carte graphique, le processeur fait ce que faisait la carte : les flous, les mélanges, la 3D et la composition de chaque image. Et avec Lenis, le scroll est déplacé par NOTRE code à chaque image : si le thread principal tourne à 5 images par seconde, la page se déplace à 5. Le scroll du navigateur est déplacé par un autre thread et reste fluide même si le thread principal est occupé (c'est pourquoi cloudflare.com va bien : son code tourne à 2 images et son écran à 86).
1. Détecter (plantillas/react/dibujoPorSoftware.ts, ou plantillas/vanilla/modo-ligero.js) : demander un contexte avec getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }) ; null signifie rendu logiciel. S'il donne un contexte, le libérer immédiatement (WEBGL_lose_context). Une fois par visite et après le premier affichage, jamais avant le LCP. ?ligero=1 le force et ?ligero=0 l'enlève ; dans une <iframe> du même domaine, on regarde aussi l'URL externe. Dans jsdom et en prerender, on suppose qu'il y a une carte graphique.
2. Uniquement dans ce cas :
- (a) Ne pas démarrer Lenis : scroll du navigateur, et à sa place une pièce native avec la même apparence (
scrollToavecsmooth,stop/startavecoverflow: hiddensur<html>pour les menus,on("scroll"),animatedScroll). Cela est géré uniquement parplantillas/react/useLenis.ts(etarrancarScroll()en vanilla). Les ancres et les menus n'ont pas chacun unif. Cela ne dépend pas dewindow.lenis: Lenis 1.3 garde déjà ses données ici. - (b)
<html data-ligero>et le CSS deplantillas/vanilla/modo-ligero.css:backdrop-filter: none; un halo defilter: blur()passe à unradial-gradientqui naît déjà diffusé (à double taille avec la propriétéscale, qui n'écrase pas letransformdu parallax) ; unmix-blend-mode(le grain enoverlay) passe à un mélange normal avec moins d'opacité. Cela se voit presque pareil et continue de bouger pareil. - (c) 3D : CHAQUE
getContextWebGL du site web est demandé avecfailIfMajorPerformanceCaveat: true, et ainsi il tombe tout seul dans sa version sans 3D, qui doit exister (une image, le logo plat ou, si c'était un ornement de fond, rien). - (d) Les animations, NON. La politique maison ne change pas : animations pour tous, on ajuste l'amplitude, on ne les éteint pas. Et c'est mesuré : dans le SaaS du tableau, retirer le fond animé ou mettre en pause celles du CSS ne changeait rien (de 28 à 29-30 images) ; dans le produit, les particules et la lumière du faisceau non plus. Ce qui pèse, c'est (a), (b) et (c).
3. Mesurer, ne pas supposer (plantillas/medir-scroll-visible.mjs, se lance depuis un dossier avec playwright-core) : compte les images qui arrivent à l'écran avec le scroll déplacé (émission d'écran de Chrome), pas les requestAnimationFrame, qui mentent avec le scroll natif. Deux mesures, toujours avec cloudflare.com à côté dans la même série : SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6 (un ordinateur sans carte graphique) et sans SIN_GRAFICA avec CPU 4 (un ordinateur portable normal). Chrome sans écran (celui de Lighthouse) rend AVEC une carte graphique : cela ne vaut pas pour ce test. Pour trouver le coupable, retirer les choses une par une avec du CSS injecté (display: none, filter: none, mix-blend-mode: normal) et remesurer : c'est ainsi que sont sortis les nuages du produit du tableau (de 0,8 s à 0,35 s jusqu'à la première image), son grain et sa démo, et on a vu que son verre de la couverture et ses particules ne pesaient rien.
Performances avec carte graphique : cinq règles pour tout site web avec scroll animé
Mesures sur deux sites web réels (sur l'un, de 580 à 355 ms de travail sur les images lentes à CPU 4x). Aucune ne supprime ou ne ralentit une animation : elles suppriment du travail qui n'était pas visible.
- Pas de
getAnimations()dans unanimationend: oblige à recalculer les styles de toute la page (~50 ms à 4x, souvent en plein milieu du scroll). Compter lesanimationstartetanimationendde l'élément. - Ne pas mettre en pause lors du scroll les animations qui ne déplacent que
transform/opacity: elles vont dans le compositeur et cela n'économise rien, et mettre en pause puis reprendre sont deux gros recalculs par scroll. - Ne pas monter des sections "pendant un moment libre" pendant le scroll : Lenis laisse des trous libres entre les images et
requestIdleCallbacktombe justement là. Attendre que le scroll s'arrête. - Ne pas écrire de styles à chaque image du scroll s'ils ne changent pas (
--bn: 0sur chaque...