Compétence Animations de Défilement Avancées
Quand utiliser cette compétence
- Lorsque la compétence
tier-based-architecturedemande un site de niveau « Premium 2D » ou supérieur. - Lorsque l'utilisateur souhaite que des éléments apparaissent en fondu, glissent vers le haut, changent d'échelle ou se fixent au fur et à mesure du défilement de la page.
- Lors de la création d'une page d'atterrissage centrée sur la narration (par exemple, des révélations de produits à la Apple).
Consignes de Ton et de Langue (Critiques)
- Toujours communiquer avec l'utilisateur dans le dialecte local jordanien/palestinien (اللهجة الأردنية والفلسطينية).
- Être professionnel mais accessible : "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
- Expliquer les choix techniques naturellement en arabe mélangé à des termes web anglais : "رح نستخدم
Framer Motionعشان حركات السكرول تطلع Smooth".
1. Configuration & Fondations
Si ces bibliothèques sont manquantes, les installer : @studio-freight/lenis (pour la base de défilement fluide) et framer-motion (pour les animations au niveau des composants).
Configuration Lenis Smooth Scroll
Chaque site utilisant cette compétence doit avoir une base de défilement fluide pour garantir que les animations paraissent premium.
- Configurer
Lenisdans un composant de haut niveau (ex.SmoothScrollProvider.tsxoulayout.tsx).
// Exemple de configuration Lenis
"use client";
import React, { useEffect } from 'react';
import Lenis from '@studio-freight/lenis';
export default function SmoothScroll({ children }: { children: React.ReactNode }) {
useEffect(() => {
const lenis = new Lenis({
duration: 1.2,
easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
orientation: 'vertical',
gestureOrientation: 'vertical',
smoothWheel: true,
wheelMultiplier: 1,
touchMultiplier: 2,
});
function raf(time: number) {
lenis.raf(time);
requestAnimationFrame(raf);
}
requestAnimationFrame(raf);
return () => {
lenis.destroy();
};
}, []);
return <>{children}</>;
}
2. Patrons d'Animation (Framer Motion)
Lors de la construction des sections, utiliser les patrons suivants pour un rendu haut de gamme :
A. Le « Fade Up Reveal »
Utiliser ceci pour les titres et les grands blocs de texte lorsqu'ils entrent dans le viewport.
- Hook :
useInViewou<motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}> - État initial :
opacity: 0, y: 40 - État d'animation :
opacity: 1, y: 0 - Transition :
duration: 0.8, ease: [0.16, 1, 0.3, 1](un easing personnalisé est crucial pour une sensation premium).
B. L'image Parallaxe
Les images doivent se déplacer légèrement plus lentement ou plus rapidement que la position de défilement.
- Hook :
useScrolletuseTransform. - Implémentation :
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
- Envelopper l'image dans un conteneur avec
overflow-hidden, et appliquer la transformationyà l'élémentmotion.imgintérieur.
C. La Liste en Cascade
Pour les grilles de fonctionnalités, les membres de l'équipe ou les cartes de tarification.
- Parent :
<motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}> - Variants (Parent) :
{ hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } } - Variants (Enfant) :
{ hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }
3. Liste de Vérification des Étapes
- Copier les instructions.
- Confirmer si Lenis est installé/configuré. Sinon, le configurer d'abord.
- Appliquer les révélations Fade Up standard au contenu textuel.
- Ajouter l'effet parallaxe aux grands médias (images/fonds vidéo).
- Ajouter les révélations en cascade aux listes/grilles.
- Construire le projet pour vérifier l'absence d'erreurs de version TypeScript ou Framer Motion.
- Dire à l'utilisateur : "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."