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()でページ遷移時に確実に後片付けする
Have a project in mind or a question about this post?