GSAP ScrollTriggerで作る、文字をなぞってマスクが広がるヒーロー演出

「Nuxt Base」のトップでは、ローディング中に「Web Development」の文字が一画ずつなぞられ、スクロールすると画面中央の窓が拡大して背景の写真が現れます。この演出を GSAP と ScrollTrigger でどう組んでいるかを紹介します。Nuxt 4 に上げた後も、同じ仕組みで動いています。

リポジトリ:Nuxtjs-TypeScript-Gsap-MicroCMS-Site / デモ:https://nuxtbase-gsap.vercel.app/

1. SVG の輪郭をなぞるローダー

文字は SVG の path で書き出し、各 path に data-delay で開始時間をずらして持たせています。getTotalLength() で線の長さを取り、stroke-dasharray と stroke-dashoffset を同じ値にすると線が見えなくなります。offset を 0 に戻すと、輪郭が描かれていくように見えます。

paths.forEach((path) => {
  const delay = Number(path.dataset.delay ?? 0)
  setTimeout(() => {
    const len = path.getTotalLength()
    path.style.strokeDasharray = `${len}`
    path.style.strokeDashoffset = `${len}`
    path.style.fillOpacity = '0'
    path.getBoundingClientRect() // 強制リフローで初期状態を確定
    path.style.transition = 'stroke-dashoffset 1.5s cubic-bezier(.65,0,.35,1), fill-opacity .7s ease'
    path.style.strokeDashoffset = '0'
    setTimeout(() => { path.style.fillOpacity = '1' }, 1500)
  }, delay)
})

途中の getBoundingClientRect() は飾りではありません。これがないと、ブラウザが「線を隠す」と「線を戻す」を同じフレームでまとめてしまい、トランジションが走りません。

2. pin + scrub でマスクを拡大する

ヒーロー部分は pin: true で画面に固定し、スクロール量に合わせて中央の要素を scale: 600 まで拡大します。scrub: 1 にすると、スクロールに 1 秒遅れて追従する滑らかな動きになります。

gsap.to('.front-img-container', {
  scale: 600,
  ease: 'ease',
  scrollTrigger: {
    trigger: '.move-section',
    scrub: 1,
    start: 'top top',
    end: 'bottom',
    pin: true
  }
})

背景の写真とマスクの画像は、PC 用とスマホ用を <picture> で切り替えています。Nuxt 4 への移行に合わせて JPEG・PNG の予備の画像を外し、WebP だけにしました。

3. Vue のライフサイクルと後片付け

Nuxt ではページ遷移のたびにコンポーネントが破棄されるため、ScrollTrigger を残したままにすると、別ページで pin が効いたままになるなどの不具合が起きます。gsap.context() でまとめて登録し、onBeforeUnmount で revert() するのが確実です。

let ctx: gsap.Context | null = null

onMounted(() => {
  if (!import.meta.client) return
  ctx = gsap.context(() => {
    gsap.registerPlugin(ScrollTrigger)
    // ここでアニメーションを登録
  })
})

onBeforeUnmount(() => ctx?.revert())

onMounted はもともとブラウザでしか実行されませんが、ブラウザ専用の処理だと読んで分かるように import.meta.client で判定しています。以前は process.client と書いていましたが、Nuxt 4 では非推奨です。

また、GSAP は SSR で読み込むと問題が出ることがあるため、nuxt.config.ts の build.transpile に 'gsap' を追加しています。

4. 動きを減らしたい人への配慮

サブページのスクロール表示(initReveal)は、prefers-reduced-motion: reduce のときは何もせずに終了します。演出が多いサイトほど、この分岐は最初に入れておくと安心です。

まとめ

  • 輪郭なぞりは stroke-dasharray/stroke-dashoffset と強制リフローで作る
  • 拡大演出は pin と scrub の組み合わせ
  • gsap.context() と revert() でページ遷移時に確実に後片付けする