S2.Solutions

Next.jsのヒーローにThree.jsを置くとき、表示速度をどう守るか

ページの一番上に3Dを置くと、何もしなければ表示速度が落ちます。初期バンドルから3Dを外す、画面外では描画を止める、動かせない環境に静止画を出す。このサイト自身で実際に効いた手当てを順番に書きます。

会社のサイトの一番上に3Dのジオラマを置きました。見た瞬間に「何をやっている会社か」が伝わる代わりに、表示速度を落とす危険がある作りです。

3Dのライブラリは大きく、描画はCPUとGPUを使い続けます。素直に置くと、文字が出るまでの時間が延び、スクロールが引っかかり、電池が減ります。ここでは、そうならないために実際にやったことを順番に書きます。フレームワークはNext.js(App Router)、3DはThree.jsを素で使っています。

前提:何を守りたいのか

「速くする」では曖昧なので、守る対象を先に決めます。

  • 文字が出るまでの時間:ページの主役は見出しとリード文です。3Dの読み込みがこれを遅らせてはいけません
  • レイアウトのずれ:3Dの枠が後から広がって本文が飛ぶのは最悪です
  • 動かし続けるコスト:画面の外に出た3Dを回し続ける理由はありません

この3つを順に潰していきます。

1. 3Dのライブラリを初期バンドルから外す

最初にやるのはこれです。Three.jsはminifyしても数百KBあります。最初に読み込むJavaScriptに混ざると、その分だけ操作できるようになるまでが遅れます。

やることは単純で、動的importにするだけです。

useEffect(() => {
  let disposed = false;

  void import("./scene").then(({ createDiorama }) => {
    if (disposed) return;
    handleRef.current = createDiorama(canvas, stage, options);
  });

  return () => {
    disposed = true;
    handleRef.current?.dispose();
  };
}, []);

ここで引っかかりやすい落とし穴があります。動的importにしたつもりでも、同じファイルから型以外のものを静的importしていると、まとめて初期バンドルに入ります。

私は最初、吹き出しに出す文言の定数を3Dのシーンと同じファイルに置いていました。

// これがあると scene.ts ごと初期バンドルに入る
import { DIORAMA_INFO } from "./scene";

このせいで、トップページの First Load JS が 255kB ありました。定数と型だけを別ファイルに切り出し、3Dのコードを触るのは動的import経由だけにしたら 108kB に下がりました。半分以上が「外したつもりで外れていない」分でした。

型だけのimportは消えるので問題ありません(import type を使うか、verbatimModuleSyntax を有効にして機械的に強制するのが安全です)。

ビルドの出力で確かめるのが確実です。ページのサイズが3Dライブラリのぶんだけ増えていたら、どこかに静的な参照が残っています。

2. 枠を先に確保する

3Dは読み込みが終わってから描かれます。その間の場所を空けておかないと、描画が始まった瞬間に下の要素が押し下げられます。

CSSの aspect-ratio で先に確保します。

.stage {
  aspect-ratio: 5 / 4;
  width: 100%;
}

高さを数値で決め打ちしないのがポイントです。幅が変われば高さも比率で追随するので、画面幅によらずずれません。

あわせて、ページの主役の要素を3Dにしないようにします。一番大きく表示される要素が3Dだと、その読み込み完了までが「表示が終わった時刻」として測られてしまいます。見出しのテキストを主役にしておけば、3Dの読み込みは測定対象の外です。

3. 画面の外では描画を止める

3Dは放っておくと毎フレーム描き続けます。ページを下までスクロールして3Dが見えなくなっても、CPUとGPUは回り続けます。

IntersectionObserver で見えているかを監視し、見えていないあいだは次のフレームを予約しないようにします。

let visible = true;
let rafId = 0;

function frame(now: number) {
  rafId = 0;
  // ...描画...
  if (busy && visible) rafId = requestAnimationFrame(frame);
}

function requestRender() {
  if (!rafId) rafId = requestAnimationFrame(frame);
}

new IntersectionObserver(
  (entries) => {
    visible = entries[0]?.isIntersecting ?? false;
    if (visible) requestRender();
  },
  { threshold: 0 },
).observe(stage);

もうひとつ効くのが、動きが落ち着いたら止めることです。上のコードの busy がそれで、着地のアニメーションが終わり、カーソルも動いていないなら、次のフレームを予約しません。常時アニメーションのない画なら、静止しているあいだの描画コストはゼロになります。

4. 動かせない環境・動かしたくない人に静止画を出す

3Dが動かない環境は実在します。WebGLが無効な環境、古い端末、そして動きを減らす設定をしている利用者です。

OSの「視差効果を減らす」設定は prefers-reduced-motion で読めます。ここでは動きを止めるだけでなく、完成した状態の1枚を描くのが大事です。アニメーションの途中で止めると、積み木が空中に浮いたままになります。

// reduced-motion のときは、着地が終わった時刻の1枚だけを描く
const t = reduceMotion ? 10 : (now - start) / 1000;

時刻を進めた状態から始めれば、同じ描画コードのまま完成形が出ます。分岐を増やさずに済みます。

WebGLが使えない場合は、生成そのものが失敗します。例外を握って、代わりの文章を出します。このとき、3Dで伝えるはずだった内容を言葉で書いておくのを忘れないようにします。絵が出ないこと自体より、情報が欠けることのほうが問題です。

try {
  renderer = new WebGLRenderer({ canvas, antialias: true, alpha: true });
} catch {
  return null; // 呼び出し側でフォールバックを表示する
}

5. 端末に合わせて重さを落とす

同じ設定を全端末に出す必要はありません。

  • 解像度の上限を決める:devicePixelRatio をそのまま使うと、高精細な画面では描くピクセル数が4倍以上になります。2で頭打ちにします
  • 影を切る:影はコストが高い割に、小さく表示される画では効果が薄いです。CPUのコア数や画面幅を見て切ります
renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 2));

const shadows = (navigator.hardwareConcurrency ?? 8) >= 4 && window.innerWidth >= 600;
renderer.shadowMap.enabled = shadows;

判定の基準に厳密な正解はありません。切ったときに絵が破綻しないことのほうが大事なので、影ありきの構図にしないでおきます。

6. ページ内に3Dを増やさない

これが一番効きます。

このサイトには実績を紹介する小さなジオラマが6つありますが、すべてSVGで描いています。WebGLの描画領域をページ内に増やすと、数に比例して重くなります。等角投影の絵であれば、SVGとCSSアニメーションで十分に表現できます。

3Dを使うのはページに1か所だけ、と決めておくと判断に迷いません。

おまけ:バージョンを上げたら色が沈んだ

移植の途中で引っかかった点を書いておきます。

試作を古いバージョンのThree.jsで作り、実装で最新版に上げたところ、同じ数値を入れているのに絵全体が暗くなりました。白い台座が灰色になり、黄色が暗いオリーブ色になりました。

原因はライトの扱いの変更です。r155以降でライトが物理的な単位で解釈されるようになり、それ以前の「明るさ」とは意味が変わっています。以前と同じ見た目にするには、強度に Math.PI を掛けます。

const LEGACY_LIGHT_SCALE = Math.PI;

scene.add(new HemisphereLight(0xffffff, 0xc9d2de, 0.85 * LEGACY_LIGHT_SCALE));
const sun = new DirectionalLight(0xffffff, 0.75 * LEGACY_LIGHT_SCALE);

型検査もビルドも通り、エラーも出ないので、見比べないと気づけません。試作から移植するときは、両方をブラウザで開いて並べる工程を必ず挟むようにしています。

まとめ

順番に効く手当てを並べます。上から順にやれば、だいたい足ります。

  1. 3Dのライブラリを動的importで初期バンドルから外す(型以外の静的importが残っていないか出力で確認する)
  2. aspect-ratio で枠を先に確保する
  3. ページの主役を3D以外のテキストにする
  4. 画面外では描画を止める。動きが落ち着いたら次のフレームを予約しない
  5. prefers-reduced-motion では完成形の1枚を出す
  6. WebGLが使えないときは、内容を言葉で伝えるフォールバックを出す
  7. 解像度の上限を決め、端末に応じて影を切る
  8. ページ内にWebGLの描画領域を増やさない

3Dは「置くかどうか」より「置いたあと何を諦めるか」を決めるほうが難しい部分です。速度と見た目のどちらかを捨てるのではなく、見えていないときと動かせないときに何もしないという方針にすると、両方を残せます。

開発のご相談

この記事のような設計・実装を、受託開発のほか、業務委託(準委任)での開発チームへの参画という形でも引き受けています。まだ要件が固まっていない段階でご相談いただけます。