Перейти к содержимому

ScrollTrigger

Для использования ScrollTrigger с Glaze специальный синтаксис не нужен. Поскольку он задан в свойстве scrollTrigger объекта анимации, его настройки можно менять через точечную нотацию.

Настройка

Сначала зарегистрируйте ScrollTrigger с помощью GSAP:

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

gsap.registerPlugin(ScrollTrigger)

Затем, как обычно, инициализируйте Glaze.

Использование

Добавьте свойства scrollTrigger.* в анимацию:

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

[&] означает «использовать этот элемент как триггер» (то же, что & в селекторах).

Для отдельного элемента Glaze переносит настройки scrollTrigger из анимации во временную шкалу, созданную для этого элемента, поэтому вся анимация управляется прокруткой.

Внутри временных шкал

Дочерние элементы элемента tl становятся твинами в общей временной шкале, а Glaze оставляет их настройки scrollTrigger у твина. GSAP не поддерживает ScrollTrigger у твина, вложенного во временную шкалу, поэтому задайте его на элементе временной шкалы, используя двоеточие для настроек временной шкалы:

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>

Чтобы запускать прокруткой анимацию всех элементов одновременно, задайте параметр в значениях по умолчанию временной шкалы.

Общие параметры

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>
Параметр Назначение
scrollTrigger.trigger-[&] Элемент, запускающий анимацию
scrollTrigger.start-[top_center] Когда начинать (позиция элемента + позиция области просмотра)
scrollTrigger.end-[bottom_top] Когда завершать
scrollTrigger.scrub-true Связывает ход анимации с положением прокрутки
scrollTrigger.markers-true Показывает отладочные маркеры (полезно при разработке)

Не забывайте заменять пробелы в значениях символами подчеркивания: [top_center], а не [top center].