跳转到正文

ScrollTrigger

使用 ScrollTrigger 和 Glaze 时无需特殊语法。由于它定义在动画对象的 scrollTrigger 属性中,可以使用点表示法调整其设置。

设置

首先,使用 GSAP 注册 ScrollTrigger:

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