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