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] を使います。