Перейти до вмісту

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].