ScrollTrigger
Aucune syntaxe spéciale n'est nécessaire pour utiliser ScrollTrigger avec Glaze. Comme cette option est définie dans la propriété scrollTrigger de l'objet d'animation, vous pouvez utiliser la notation par points pour ajuster ses paramètres.
Configuration
Commencez par enregistrer ScrollTrigger avec GSAP :
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"
gsap.registerPlugin(ScrollTrigger)
Initialisez ensuite Glaze comme d'habitude.
Utilisation
Ajoutez les propriétés scrollTrigger.* à votre animation :
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>
[&] signifie « utiliser cet élément comme déclencheur » (comme le & dans les sélecteurs).
Sur un élément autonome, Glaze déplace les paramètres scrollTrigger de l'animation vers la timeline qu'il crée pour cet élément, de sorte que toute l'animation soit pilotée par le défilement.
Dans les timelines
Les enfants d'un élément tl sont des tweens dans une timeline partagée, et Glaze conserve leurs paramètres scrollTrigger sur le tween. GSAP ne prend pas en charge ScrollTrigger sur un tween imbriqué dans une timeline : placez-le plutôt sur l'élément de la timeline, en utilisant la forme avec deux-points pour les paramètres de la timeline :
<div data-animate="tl scrollTrigger:trigger-[&]|start-[top_center]">
<div data-animate="to:rotate-360"></div>
<div data-animate="to:rotate-360"></div>
</div>
Pour déclencher le défilement de tous les éléments en même temps, définissez-le dans les valeurs par défaut de la timeline.
Options courantes
<div
data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
<div class="flex h-[50vh] items-center">
<div
class="h-20 w-20 rounded-xl bg-amber-500 sm:invisible"
data-animate="from:autoAlpha-0|rotate-180|y-50|scrollTrigger.trigger-[&]|boxShadow-[0_0_100px_20px_orange]|scrollTrigger.scrub-true|scrollTrigger.start-[top_center]|scrollTrigger.end-[-=200]"
></div>
</div>
| Option | Fonction |
|---|---|
scrollTrigger.trigger-[&] |
Élément qui déclenche l'animation |
scrollTrigger.start-[top_center] |
Quand commencer (position de l'élément + position dans la fenêtre d'affichage) |
scrollTrigger.end-[bottom_top] |
Quand terminer |
scrollTrigger.scrub-true |
Relier la progression de l'animation à la position de défilement |
scrollTrigger.markers-true |
Afficher les repères de débogage (utiles pendant le développement) |
Pensez à utiliser des traits de soulignement au lieu des espaces dans les valeurs : [top_center] et non [top center].