Aller au contenu

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 :

JavaScript
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 :

HTML
<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 :

HTML
<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

HTML
<div
  data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
HTML
<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].