コンテンツへスキップ

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