Saltar al contenido

ScrollTrigger

No hace falta ninguna sintaxis especial para usar ScrollTrigger con Glaze. Como se define dentro de la propiedad scrollTrigger del objeto de animación, puedes usar la notación de puntos para ajustar su configuración.

Configuración

Primero, registra ScrollTrigger con GSAP:

JavaScript
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"

gsap.registerPlugin(ScrollTrigger)

Después, inicializa Glaze como de costumbre.

Uso

Añade propiedades scrollTrigger.* a tu animación:

HTML
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>

[&] significa «usar este elemento como activador» (igual que & en los selectores).

En un elemento independiente, Glaze traslada la configuración scrollTrigger de la animación a la línea de tiempo que crea para ese elemento, de modo que toda la animación se controla mediante el desplazamiento.

Dentro de líneas de tiempo

Los elementos secundarios de un elemento tl son interpolaciones dentro de una línea de tiempo compartida, y Glaze mantiene su configuración scrollTrigger en la interpolación. GSAP no admite un ScrollTrigger en una interpolación anidada dentro de una línea de tiempo, así que colócalo en el elemento de la línea de tiempo, usando los dos puntos para indicar la configuración de la línea de tiempo:

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>

Para activar el desplazamiento de todos los elementos a la vez, configúralo en los valores predeterminados de la línea de tiempo.

Opciones habituales

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>
Opción Función
scrollTrigger.trigger-[&] Elemento que activa la animación
scrollTrigger.start-[top_center] Cuándo empezar (posición del elemento + posición de la ventana gráfica)
scrollTrigger.end-[bottom_top] Cuándo terminar
scrollTrigger.scrub-true Vincula el progreso de la animación a la posición de desplazamiento
scrollTrigger.markers-true Muestra marcadores de depuración (útiles durante el desarrollo)

Recuerda usar guiones bajos en lugar de espacios en los valores: [top_center], no [top center].