メインコンテンツへスキップ
見出し画像

[R3F / GSAP] アニメーションでウェブサイトの表現を拡張する

    これはフェンリル デザインとテクノロジー Advent Calendar2025 25日目の記事です。

    はじめに

    初めまして!新卒でWebエンジニアをやっている273*(ツナサンド🥪)と申します。普段はWebアプリケーションやツールの開発をしています。
    Webは単なるツールとしてだけではなく、面白いアニメーションやデザインの表現が可能です。それを布教するため、今回は2年ぶりに完全刷新したポートフォリオサイトのトップページの表現や実装方法について紹介、解説したいと思います!
    3DCGの用語や数学も少し出てくるので、なるべく説明を入れながら解説していきますが、難解な部分もありますので雰囲気だけでもゆる〜くご覧ください!
    サイトは以下のリンクから閲覧していただけます。

    サイトデザイン

    画像
    Figma - 初期案

    サイトデザインは、私が好きなSwiss Styleの考え方を取り入れました。色数と情報量を抑えつつ、タイポグラフィ・余白・グリッドを中心に構成しました。白黒にすることにより、カラー写真などがより際立つようにしています。
    趣味でデザインをやっている程度なので素人ですが、要素を整理し、視線が自然に流れるように配置することで、シンプルかつ機能的なレイアウトを目指しました。テーマを切り替えても違和感がないようになっています。各ページにおいて、タイポやスクロールアニメーションを実装しているため、触っていて楽しいと思います。フォントはGeistを使用しています。Next.js標準なのが嬉しいです。

    トップページでは、訪れたユーザーが楽しめる仕掛けとして、3Dロゴを使ったページ遷移を実装しました。オブジェクトをホバーすると、枠とカーソルにページ名が現れ、クリックすると遷移する仕組みです。
    当初はこの動作のみを想定していましたが、さらに回転アニメーションでマテリアルに影響を与えたり、物理演算を組み込むことで、アクセスするたびに異なる表情を楽しめるようになりました。

    画像
    トップページ

    3Dロゴのマテリアルは、液体金属とガラスの中間のようなものをイメージしました。さらにポストエフェクトをかけることで質感を高めています。これによりシンプルながらダイナミックな表現に落とし込むことができました。制作の初期段階でこのトーンを定めたことで、OGP画像やShowcaseページの画像処理においても、一貫した世界観を保つことができました。

    技術スタック

    主に使用した技術は以下になります。今年10月末にリリースされたNext.js 16で登場したCache ComponentsやPPRの機能を活かして高速なページ表示を実現しています。
    今回はR3FとGSAPの実装について焦点を当てていきます。ビルド時やコマンドでStrapiから型を自動生成したり、i18nの実装をしたり色々やりましたが、Next.jsやStrapiについては割愛させていただきます🙇‍♂️

    言語、FW:TypeScript, GLSL, Next.js 16
    UI コレクション:shadcn/ui
    3Dアニメーション:React Three Fiber (以降 R3F), Drei, Rapier
    2Dアニメーション: GSAP
    ヘッドレス CMS : Strapi Cloud
    デプロイ:Vercel

    トップページは3Dアニメーションと2Dアニメーション、レイアウトのレイヤーに分かれており、それらを重ねることで表現しています。

    3Dアニメーションの実装

    トップページの3Dロゴの演出を実装します。
    上記のデザインやアニメーションを実現するために、パフォーマンスの最適化にも力を入れました。実装したマテリアルとポストエフェクトはそもそも処理負荷が高く、さらに物理演算も組み合わせているため、そのままでは動作が重くなります。そこでパラメータや処理の調節をして軽量化した結果、スマホでもスムーズに操作できるようになりました(横画面でも表示されます)。

    1. モデルの作成

    3DロゴモデルのメッシュはBlenderを用いてsvg画像から作成しました。メッシュとは以下の画像のように頂点、辺、面といったポリゴンの集まり、つまりオブジェクト実体のことです。オブジェクトごとにイベントを受け付けるようにしたいので、個別オブジェクトに切り分けて一つのglbファイルにエクスポートします。自前でテクスチャやマテリアルを作成した場合はベイク(計算結果を保存)して画像にしておきます。

    画像
    4つのオブジェクトに分けている

    2. モデルの読み込み

    R3FのヘルパーであるDreiを用いてモデルを取り込みます。R3Fとは、Three.jsをReactのコンポーネントとして記述できるライブラリです。とても簡単で豊富なエコシステムが提供されており、Reactフックもそのまま使えるので重宝しています。便利すぎてThree.jsで書けないようになってきました。

    const { nodes } = useGLTF("./glb/logo.glb");

    nodesには先ほど作成したメッシュの情報が入っているの、でmap関数を使って一つずつ取り出し、SplitLogoModelコンポーネントにメッシュを渡します。このコンポーネントではマテリアルの指定やホバー時の動作を実装しています。オブジェクトをグループ化し、x軸方向に90度(π/2)回転させてカメラの正面を向くようにしています。

    <group scale={30} rotation={[Math.PI / 2, 0, 0]} ref={meshRef}>
      {Object.entries(nodes)
        .filter(([, node]) => node.type === "Mesh")
        .map(([key, mesh], i) => {
          return <SplitLogoModel key={key} mesh={mesh} index={i} />;
      })}
    </group>

    メッシュからジオメトリ(geometry)を取り出してオブジェクトを表示します。ジオメトリとは、形状データのことを指します。onClickメソッドでオブジェクトがクリックされたらページ遷移するようにしています。

    <mesh 
      geometry={(mesh as THREE.Mesh).geometry}
      onClick={() => {
        setArrowTitle(null);
        redirect(href === "/contact" ? href : `/${DEFAULT_LOCALE}${href}`);
      }}
    >
      <Material />
    </mesh>

    マテリアルは一旦色がはっきりしているノーマルマップでわかりやすくします。本来は凹凸や光の当たり方を擬似的に表現するのに使います。

    画像
    モデルを読み込む

    3. モデル枠の作成

    オブジェクトをホバーした時にオブジェクトのBounding Boxを表示します。Bounding Boxとはオブジェクトを囲む最小の直方体の領域のことです。画像解析などでは2Dのものをよく見ますが、それの3D版を実装します。なんとなくかっこいいですよね。

    先ほど渡されたジオメトリからBounding Boxを計算します。オブジェクト本体とBounding Boxが干渉するのを防ぐため、サイズをほんの少し大きく設定するのがポイントです。これにより滑らかにマウスホバーが動作します。

    // バウンディングボックスを計算
    geometry.computeBoundingBox();
    const { boundingBox } = geometry;
    
    if (!boundingBox) return { boxGeometry: null, boxPosition: null };
    
    // バウンディングボックスのサイズと中心を計算
    const size = new Vector3();
    const center = new Vector3();
    
    boundingBox.getSize(size);
    boundingBox.getCenter(center);
    
    // ロゴモデルの上に当たり判定を設定するため小さな値を追加
    size.addScalar(0.0001);
    
    // 計算結果からBoxGeometryを作成
    const boxGeom = new BoxGeometry(size.x, size.y, size.z);
    
    return {
      boxGeometry: boxGeom,
      boxPosition: center.toArray() as [number, number, number],
    };
    

    Bounding Boxのジオメトリからメッシュを作成します。

     const boundingBoxMesh = useMemo(() => {
        if (!boxGeometry || !boxPosition) return null;
    
        const mesh = new Mesh(boxGeometry);
        mesh.position.set(boxPosition[0], boxPosition[1], boxPosition[2]);
        return mesh;
      }, [boxGeometry, boxPosition]);
    
      return boundingBoxMesh ? (
        <RoutingElement
          node={boundingBoxMesh}
          position={boxPosition ?? undefined}
        />
      ) : null;

    RoutingElementコンポーネントには、GLSLで実装したBounding Boxのマテリアル(斜線と頂点の + マーク)を指定しています。GLSLとはシェーダーを描くための言語です。かなり難しく、これだけで記事が書けるほどなので今回は割愛します。ざっくりですが、3次元空間のオブジェクトの頂点座標を行列で2次元(画面上)に座標変換・射影し、2次元の各頂点に指定したキャンバスに対してピクセル単位で色を塗っているイメージです。以下は + マークの例です。

    // vertex shader
    void main() {
      // 頂点のサイズを18x18ピクセルに指定
      gl_PointSize = 18.0;
    
      // オブジェクト座標系 -> ウィンドウ座標系
      gl_Position = projectionMatrix * viewMatrix * modelMatrix * vec4(position, 1.0);
    }
    // fragment shader
    void main() {
      // 0~1(18x18の頂点エリア)を-1~1に正規化
      vec2 coord = gl_PointCoord * 2.0 - 1.0;
      
      // 線の太さ
      float thickness = 0.25;
    
      // + マークの描画
      if (abs(coord.x) < thickness || abs(coord.y) < thickness) {
        gl_FragColor = vec4(0.5, 0.5, 0.5, 1.0);
      } else {
        discard; 
      }
    }

    GLSLは以下のサイトを参考にしました。また、同コンポーネントでホバー時の表示切り替えも管理しています。

    画像
    Bounding Box

    4. シーンづくり

    コードがかなり複雑になるので、コンポーネントごとに役割を持たせます。モデルや環境マップの読み込みなどが完了するまで待機するようにするため、<Suspense>でラップしています。fallbackにローディングアニメーションなどを設定するとよりいい感じです。

    <Canvas
      gl={{
        powerPreference: "high-performance",
        antialias: false,
        stencil: false,
        depth: true,
        alpha: true,
        preserveDrawingBuffer: true,
        failIfMajorPerformanceCaveat: false,
      }}
      camera={{ fov: 30, near: 0.1, far: 1000, position: [0, 2.25, 5] }}
    >
      <Suspense fallback={null}>
        <OrbitControls enableZoom={false} enablePan={false} />
        <Model />
        <EnvironmentLight />
        <PostProcess />
      </Suspense>
    </Canvas>

    カメラ
    カメラ制御はDreiのOrbitControlsを使用して回転のみできるよう制限しています。オブジェクトの位置やサイズに応じて、適切なカメラの座標や視野角を設定します。

    モデル
    先ほどのモデルに関する実装を一つのコンポーネントにまとめたものです。

    環境光
    環境テクスチャでオブジェクトの反射や、全体的に自然になるよう明るさの調節をしています。テクスチャは以下のサイトなどから取得できますが、今回はライブラリに含まれるプリセットを使っています。内部的にはcdnを使っているようです。Cloudflareが落ちた時にエラーで表示できなかったので手動設定する方がいいかもです。

    画像
    preset="night"

    5. 回転アニメーション

    オブジェクトが読み込まれたら回転させるようにします。フレーム単位で回転数値を線形ではなくイージングで変化させます。イージングとは、映像制作などにもよく使われる、動作の緩急のことを指します。今回はeaseOutCircを使用しました。自身でベジェ曲線やキーフレームを設定できるTheatre.jsを使ったりするとより細かい調整ができますが、オーバースペックなので基本的には不要です。

    const easeOutCirc = (t: number) => {
      return Math.sqrt(1 - Math.pow(t - 1, 2));
    };

    f(t)=1−(t−1)2,0≤t≤1f(t) = \sqrt{1 - (t - 1)^2}, \quad 0 \le t \le 1
    (x−1)2+y2=1,0≤x,y≤1(x - 1)^2 + y^2 = 1, \quad 0 \le x, y \le 1
    右にずれた円の左上部分を値として使用します。

    最初の200フレーム(3秒くらい)の間はオブジェクトを回転させます。関数easeOutCircの引数は0〜1の範囲を前提としているため、正規化して使用する必要があります。今回はframe / 240という形で0〜約0.83(200/240)の範囲に正規化しています。0.83(円の頂点手前)くらいで余裕を残すことで自然に次のアニメーションへ繋げられます。縦方向の揺れは、sin関数の引数に時間を代入しているだけです。

    useFrame((state: RootState, delta: number) => {
      const meshGroup = meshRef.current;
    
      if (meshGroup) {
        // 最初の200フレームで回転アニメーション
        if (frameRef.current <= 200) {
          const frame = frameRef.current;
          const rotSpeed = easeOutCirc(frame / 240) * Math.PI * 10;
    
          // z軸中心に時計回りに回転
          meshGroup.rotation.z = rotSpeed;
    
          // y軸方向(上下)にsin波で揺れる
          meshGroup.position.y = Number(Math.sin(state.clock.elapsedTime)) * 0.2;
    
          frameRef.current += 1;
        } else {
          meshGroup.rotation.z += delta * 0.2;
    
          // 回転アニメーション終了後、物理演算を有効にする
          if (isPhysicsPaused) {
            setIsPhysicsPaused(false);
          }
        }
      }
    });

    200フレーム以降は物理演算に入ります。setIsPhysicsPausedで物理演算をするかどうかの切り替えをしています。z軸回転はdelta(変化量)を足してあげるだけ終わりです。あとはmeshRefをモデル読み込みの際に作成した<group>にセットしてあげれば完了です。

    6. 物理演算

    R3Fの物理演算ライブラリにはRapierやCannonなどの選択肢がありますが、後者は現在ほとんど更新が止まっており、前者のほうが軽量で高性能であることから、Rapierを採用しました。

    当初はマテリアルやポストエフェクトに大きな負荷がかかっており、まともに動かせる状況ではありませんでした。物理演算からオブジェクトの位置情報をベイクしてしまおうと考えていましたが、それでは毎度同じ動きになってしまうので楽しくありません。これについてはマテリアル、ポストエフェクトの調整で解決しました。

    物理演算の実装はとても簡単です。
    まずは全体を<Physics>コンポーネントでラップし、物理空間を作成します。pausedにbooleanを指定することで物理演算を一時停止したり再開したりできます。

    <Physics paused={isPhysicsPaused}>
      <group>
        ...
      </group>
    </Physics>

    次にメッシュを<RigidBody>コンポーネントでラップします。これでメッシュが剛体として扱われます。
    collidersでは当たり判定を設定できます。ball(球体)やcuboid(直方体)のほかにhullやtrimeshを設定できます。trimeshはジオメトリそのものを当たり判定として設定できますが、かなり負荷が高いです。私のMacbook Air M2ではまともに動きませんでした。
    そのためモデルを包み込むような「凸形状」を自動生成してくれるhullを指定しました。軽量で当たり判定もジオメトリに近いので、これで十分です。frictionで摩擦、restitutionで反発係数を指定して少しだけ跳ねるようにします。

    <RigidBody colliders="hull" ccd friction={1} restitution={0.9}>
      <mesh>
        ...
      </mesh>
    </RigidBody>
    画像
    colliders="hull"

    床を<CuboidCollider/>で作成し、オブジェクトより低い位置に配置することで、物理演算が有効になった時に落下するようにします。

    7. マテリアル

    序盤の解説の通り、マテリアルは液体金属とガラスの中間のようなものを表現するため、DreiのMeshTransmissionMaterialを使用しました。このマテリアルは、透明度や厚み、屈折、表面の粗さなどを細かく調整して、ガラスやスライム、透明樹脂のような表現が可能です。
    今回は液体金属のような歪みと光の反射を再現しました。表面の粗さを0.4にして適度なツヤを持たせ、屈折は10、裏面は15に設定しています。歪みを20、時間的歪みを0.01設定することで時間変化がある液体のような表現になります。
    また、resolution(レンダリング解像度)とsamples(屈折サンプル)は、roughness(粗さ)も相まってレンダリング品質に大きく関わってくる項目です。いずれも数値を高くするとより綺麗な質感になりますが、負荷が大きくなります。そもそもこのマテリアル自体が高負荷なため、検証を重ねて、スマホでも動作するギリギリのラインを攻めました。サンプル数は15あたりが限界で、それに合わせてレンダリング解像度を設定しています。

    <Outlines thickness={1.5} color="#fff" />
    <MeshTransmissionMaterial
      roughness={0.4}
      backside
      backsideThickness={15}
      thickness={10}
      distortion={20}
      temporalDistortion={0.01}
      resolution={768}
      samples={15}
    />

    さらにオブジェクトのアウトラインを白色固定で設定しています。デフォルトの背景が黒色なので、アウトラインを加えることでのっぺりした感じから一気に引き締まります。
    Dreiには、オブジェクトのアウトラインを描画するためのOutlinesマテリアルが用意されています。対象のオブジェクトをシルエット的に描画してくるマテリアルです。

    画像
    上:アウトラインなし
    下:アウトラインあり

    個人的にEdgesマテリアルの方が綺麗なアウトラインを描画できていると感じたため、当初はそちらを使用していました。しかし、物理演算を導入したときにオブジェクトが動かなくなりました。どうやらEdgesは内部で追加のメッシュやグループを作成しているようで、RigidBodyの設定と干渉しているようでした。Outliinesでも十分綺麗なので良かったです。

    8. ポストエフェクト

    シーンに質感を持たせるためにポストエフェクトを適用します。ポストエフェクトとは、カメラのエフェクトやフィルター効果のようなものです。後処理やPost Processingとも呼ばれます。
    今回はditherエフェクトに近いエフェクトを実装したかったので、postprocessingのDotScreenを使用しました。漫画のようなドットのエフェクトです。ドットの大きさは2.5に設定しています。ポストエフェクトの設定で当初はmultisamplingを8に設定しており、まともに動かせませんでした。multisamplingは数値が高いほど描画のギザギザが滑らかになります(アンチエイリアス)。今回はドットエフェクトなので無しにしても品質は変わりませんでした。そのおかげで軽量化することができました。

    <EffectComposer multisampling={0}>
      <DotScreen angle={Math.PI * 0.5} scale={2.5} />
    </EffectComposer>
    画像
    ポストエフェクトあり

    今回はプリセットを使用しましたが、マテリアルやポストエフェクトに時間やマウスカーソルの動きを用いる場合はGLSLで制御する必要があります。

    心残り🥺

    当初は、後ろのテキストの影響を受けてマテリアルを歪ませる予定でした。しかし、オブジェクト化したHTML要素ではそれができなかったのと、3D化したテキストにアニメーションを実装しても、常にカメラを向かせるBillboard機能の動作が不安定だったことから見送りました。近いうちにリベンジしたいところです。これが実装できていたらよりガラスっぽくなっていました😥

    ※ 追記:
    こちらを再現してみましたが、歪みがわかりにくい上に本マテリアルの方が綺麗でした😇
    ソースはこちらから閲覧していただけます。

    2Dアニメーションの実装

    トップページのテキストアニメーションの演出を実装します。今回はReact版のGSAPを使用しました。今年の夏頃に全機能が完全無料になりましたね!初心者なので簡単な実装しかできませんでしたが、以下の動画のようにキネポやモーショングラフィックスのような凝った表現を実装することも可能です。

    https://gsap.com/

    1. フォントの自動調節機能

    今回はテキストが下から競り上がるアニメーションに加え、親要素の幅いっぱいにフォントサイズを自動で調整するようにしました。シンプルな画面構成のため、大きな文字で目立たせたかったのです。CSSやTypeScriptでフォントサイズをコントロールするのも少し面倒だったので、React Fittyを使用しました。<ReactFitty>でテキスト要素をラップするだけなので楽です!

    2. テキストアニメーション

    テキストアニメーションはGSAPのSplitTextプラグインを使用しました。こちらも慣れれば簡単です!

    https://gsap.com/docs/v3/Plugins/SplitText/

    useGSAPの中に処理を実装します。refで要素を指定してテキストを1文字ずつ自動分割するように設定します。idやclassでも指定できます。はみ出し防止のためマスクも設定します。マウント時に一瞬テキストが表示されるのを防ぐためにあらかじめ透明度を0%に設定しています。

    const ref = useRef<HTMLElement>(null);
    
    useGSAP(() => {
      const split = SplitText.create(ref.current, {
        type: "chars",
        autoSplit: true,
        mask: "chars",
      });
    
      ...
    }, [text]);
    
    return (
      <ReactFitty ref={ref} className="opacity-0">
        <p className={className}>{text}</p>
      </ReactFitty>
    );

    テキストが分割できたら、setメソッドでアニメーションの最初にテキスト要素の透明度を100%にします。次にfromメソッドで分割したテキストの縦100%下の位置から戻るように設定します。イージングはeaseOutExpoです。durationとstaggerでテキストを順番にアニメーションするようにします。

    gsap.set(ref.current, { opacity: 1 });
    
    gsap.from(split.chars, {
      duration: 0.5,
      yPercent: 100,
      stagger: 0.07,
      ease: "expo.out",
    });

    これだけでテキストアニメーションの完成です!また、revertメソッドを使ってコンポーネントが画面から消える時にアニメーションを停止するようにします。要素を元に戻すと同時に内部的にkillされるので安心です。設定しておかないとメモリ消費とDOM要素が増え続けて重たくなります。

    return () => {
      split.revert();
    };

    他のページでもGSAPを使用した簡単なアニメーションを実装しています。ぜひご覧ください!

    ファビコンとOGP画像

    ファビコンとOGP画像については、デザインツールのPaperで作成しました。今年の10月半ばに、液体金属のシェーダーが追加されたようで、試しに使ってみました。動きのカスタマイズも簡単に調節でき、クオリティの高いロゴアニメーションを作成することができます。実装した3Dロゴをそのまま平行投影するよりも楽でよかったです!

    画像
    OGP画像

    おわりに

    長くなりましたが、最後まで読んでいただきありがとうございました!今後も実験的な実装を進めて更新していく予定です!
    紹介していませんが、p5.jsを使うと今回とはまた違った芸術的な表現もできるのでそちらもおすすめです!3Dや2Dのアニメーションを扱えるようになると、表現の幅が広がってとても楽しいです。少しでも面白さが伝われば幸いです!

    それではまた!🎄🎅 🎁

    あなたへのおすすめ