WebGLスライダー

Three.jsで作る、煙の境界で素材を切り替えるMaterial Atlas

二つの生成レリーフを煙状のシェーダーマスクで比較するThree.js製素材アーカイブ。キーボードでの中間位置保持、明示的な確定とキャンセル、Canvasフォールバックまで設計します。

Y
Yutaka Kizaki
@junkbranding
2026年11月20日
読了時間: 10分

Reference / 参考元

Mask transition with smoke effect — Gucci Zumi

Awwwards — curated interaction element

参考サイトを見る
構成 / File Structure
</>Code Viewer
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

Day 049 — Three.jsで作る、煙の境界で素材を切り替えるMaterial Atlas

Reference study: Mask transition with smoke effect — Gucci Zumi / Awwwards — curated interaction element
主軸: Three.js / 品質レビュー: 88/100

不規則で柔らかな煙状境界による画像切り替えを参照。原作の素材や構図は使用せず、生成レリーフと編集パネルを備えた素材比較UIへ再構成した。煙の位相を進捗に固定し、キーボードでは比較位置を保持する。Three.js実装は独自設計で、原作のソース解析結果ではない。

Three.jsで作る、煙の境界で素材を切り替えるMaterial Atlas

2026-11-20公開 · Day 049 / 365

参考にした表現

参考は、Awwwardsのキュレーション要素 Mask transition with smoke effect — Gucci Zumi。画面全体を薄くするのではなく、不規則で柔らかな境界が画像を切り替える原理を研究対象にしています。

提供された参考情報では、元プロジェクトの技術表記はPixiJS/WebGL/GLSLです。本作はThree.jsによる独自の再解釈であり、原作のソースコードを解析したものではありません。ブランド、商品、イラスト、原文コピー、固有のレイアウトは使用していません。

完成形

架空の素材アーカイブ「VEIL / Material Atlas」。石灰質と赤銅色の彫刻的レリーフをCanvasで生成し、左に作品、右に素材の説明と操作を置きます。モバイルでは作品、説明、操作の順に積みます。

編集パネル内のスライダーで、煙の境界を途中まで動かして比較できます。確定済みの素材と探索中の進捗は別の状態です。探索中に本文は切り替わらず、確定アニメーションが端点に到達してから本文と選択状態を更新します。

操作の仕様

  • ポインター/タッチ: スライダーを動かして比較し、離すと確定します。42〜58%のデッドバンド内では、最後に確定した素材へ戻ります。
  • キーボード: 矢印キーで1%ずつ比較します。キーを離しても中間位置を保持します。Enterまたは「この位置で確定」で端点へ移動します。Home/Endも標準rangeの操作として使用できます。
  • キャンセル: スライダー上のEscape、または「選択に戻す」で、最後に確定した素材へ戻ります。遷移の途中を新しい確定状態にはしません。
  • 素材ボタン: 指定した素材へ直接移動します。移動中でも別の素材を選び直せます。
  • タッチの縦スクロールなどによるpointercancel: その探索を取り消し、最後に確定した素材へ戻します。

スライダーからTabで移動しても比較位置を保持します。フォーカス移動を素材選択として扱わないため、確定ボタンへ移動してから実行できます。

実装設計

依存関係と配置

このコードは Three.js 0.170.0(r170) を対象にします。Viteなど、bare importを解決できる既存のビルド環境で次のように固定してください。

npm install --save-exact three@0.170.0

package.jsonの該当部分は次の形です。

{
  "dependencies": {
    "three": "0.170.0"
  }
}

HTMLをページへ、CSSをスタイルシートへ、JavaScriptをatlas.jsへ配置し、HTMLの後から<script type="module" src="/src/atlas.js"></script>で読み込みます。このパスはVite構成の例です。ビルドを使わない配信では、別途import mapによるthreeの解決が必要です。依存の更新時は、色空間チャンクとシェーダー診断を再確認してください。

入力と確定を分ける

inputは進捗の更新だけを担当します。changeには確定処理を登録しません。ブラウザによって矢印キーの各ステップでchangeが発火しても、比較位置を端点へ戻さない構成です。

ポインター終了、Enter、明示的な確定、キャンセル、素材ボタンは、共通のsettle()に集約します。selectedは最後に確定した素材、pは探索中を含む表示進捗です。selectedを更新するのは端点到達時だけです。

pointer captureとpointer IDで、一つの操作の開始・終了を対応させます。キャンセル、予期しないcapture喪失、操作中のウィンドウ非アクティブ化では、最後の確定素材へ戻します。縦スクロールを妨げるpreventDefault()はポインター操作に使用していません。

表示と寿命

Canvas画像は同期生成してからCanvasTextureへ渡すため、外部画像のロード待ちはありません。GPUの初回描画が成立するまでは生成Canvasを表示し、import失敗、シェーダー診断エラー、コンテキスト喪失時も同じ進捗のCanvasへ退避します。

History APIは使用しません。比較・確定操作はブラウザ履歴を増やさず、戻る操作を占有しません。

シェーダー/レンダリング

全面を覆うPlaneGeometryに2枚のCanvasTextureを渡します。FBMでノイズ座標を歪ませ、別のFBMを重ねて方向性のあるスカラーフィールドを生成。進捗を閾値へ変換し、smoothstepで柔らかなマスクを作ります。

4m(1-m)を使い、UV変位を境界付近だけに限定します。静止している領域は揺らさず、新しい素材が露出する場所だけが流れる設計です。進捗0と1は明示的に分岐し、変位なしの元画像を返します。

煙の位相は時間ではなく進捗に結びつけます。同じ位置なら同じ境界を再現でき、逆操作でも不連続に飛びません。キーボードで比較位置を保持したときも、煙だけが勝手に動き続けることはありません。

正方形画像をcoverで表示し、Canvas側はobject-fit: coverで対応します。CanvasTextureにはsRGBを指定し、シェーダー出力にも色空間変換を適用します。実際の端点色一致は導入先ブラウザで確認してください。

実務での使いどころ

素材メーカーの仕上げ比較、建築スタジオの作品Hero、ブランドサイトの季節切り替え、アートディレクションのBefore/Afterに向いています。画像を切り替える演出が、そのまま素材を選ぶUIになります。

実画像へ置き換える場合は、両画像のdecode完了を待ち、画像ごとのアスペクト比をuniformへ渡してください。今回の生成画像は同じ正方形なので、共通のcover処理を使っています。細部の厳密な比較が目的なら、煙状マスクだけでなく通常の分割比較も併設するのが適切です。

調整パラメータ

パラメータ初期値用途
duration1100ms通常の確定遷移
reducedDuration140msreduced-motion時の短いクロスフェード
feather0.065境界の柔らかさ
distortion0.027境界付近のUV変位
noiseScale3.8煙の粒度
dpr最大1.6描画解像度の上限
textureSize1024生成画像の一辺
low / high0.42 / 0.58確定時のデッドバンド
rangeのstep10 / 1000キーボードの1%刻み

大きく見せたい場合でも、まずdistortionではなくnoiseScaleとfeatherから調整します。変位を増やしすぎると、素材を読むためのUIから画像を歪める演出へ目的が変わってしまいます。

パフォーマンスとアクセシビリティ

通常は操作・遷移・リサイズ時だけ描画し、非表示タブではRAFを停止します。ただし、1メッシュだから軽いとは限りません。遷移中は各フラグメントで4オクターブのFBMを3回評価します。高DPRの広い表示領域ではフィルレートが支配的になり得ます。また、2枚のCanvas生成はメインスレッドで同期実行するため、初期化時間も計測対象です。

prefers-reduced-motionではGPU演出を使わず、Canvasの短いクロスフェードへ変更します。設定変更も監視します。キーボード探索ではCanvasの混合位置も保持できます。

進捗の視覚表示であるoutputにはaria-live="off"を設定します。探索値はrangeのaria-valuetext、確定結果は専用ライブリージョンで伝えます。進捗表示を毎フレーム更新することと、確定結果を通知することを分離しています。実際の読み上げ挙動は支援技術との組み合わせで確認してください。

本文は14px、操作ラベルは13pxを基本にし、細かな管理情報は11〜12pxとしています。フォーカスリングを維持し、ボタン・スライダーの操作領域は44px以上確保します。

SPAで撤去するときは、ルート要素のdailyDestroy()を呼び出してください。再実行時も先に既存インスタンスを破棄します。RAF、イベント、ResizeObserver、Geometry、Material、Texture、Renderer、生成Canvasを解放し、静的SVGと初期の本文へ戻します。

未検証項目と確認手順

この回答内ではブラウザ・実機・性能の実測は行っていません。導入時は以下を確認してください。

  1. Chrome、Safari、Firefoxでシェーダーのコンパイル、端点の色、Canvasとのcover位置を確認する。
  2. 矢印キーをゆっくり繰り返し、キーを離しても中間位置を保持することを確認する。Enterで確定し、Escapeで最後の確定素材へ戻ることも確認する。
  3. Tabでスライダーから確定ボタンへ移動しても、比較位置が変わらないことを確認する。
  4. 実機タッチでドラッグの追従、縦スクロール、pointercancel後の復帰を確認する。320px幅と760px前後では組版と文字の読みやすさも確認する。
  5. 素材ボタンの連打、遷移中の逆操作、途中キャンセルで、最終画像・本文・aria-pressedが一致することを確認する。
  6. NVDAやVoiceOverで、進捗の視覚表示が継続的な通知を発生させず、rangeの値と確定通知を区別できることを確認する。
  7. reduced-motionを実行中に変更し、GPUとCanvasが重複表示されないことを確認する。
  8. import失敗とコンテキスト喪失を再現し、Canvasで比較・確定操作を続けられることを確認する。
  9. 初期Canvas生成時間とモバイルのフレーム時間を計測する。必要に応じてDPR、画像解像度、FBMのオクターブ数を下げる。
  10. 再マウントと破棄を繰り返し、イベントとGPUリソースが増加しないことを確認する。

タグ

Three.jsGLSLshader maskingCanvasTextureマテリアル探索アクセシビリティDaily Lab

表現タイプから探す

WebGLスライダー

Three.jsとカスタムシェーダーによって画像の境界を設計し、作品や素材の比較・選択に接続するWebGLスライダー。

3件

カード・UIパーツ系

カード・UIパーツ系に関する実装記事です。

2件

GLSLパーティクルナビゲーション

GLSLによる粒子の分散・集合・保持を作品選択と結びつけ、閲覧状態を立体的な構造として伝えるWorks向けインタラクション。

1件

GLSLポストプロセスHero

生成シーンや画像をオフスクリーンで描画し、GLSLの変位場・色収差・合成処理を、Heroの入力応答や比較UIへ結びつける表現。

1件

GLSLマテリアルコントローラー

GLSLの連続的な画像変形を、素材の質感や状態を探索するドラッグ・キーボード操作UIとして設計するデザインスタディ。

1件

Three.jsキネティックタイポグラフィ

Three.jsとシェーダーで文字の形状をインタラクティブに変形し、ブランドHeroやキャンペーンの見出しに展開するキネティックタイポグラフィ。

1件

WebGPU深度パララックスHero

WebGPUの透視投影と深度別レンダリングを、ブランドのHeroや作品探索に結び付ける空間パララックス表現。

1件

WebGPU画像トランジション

WebGPUとWGSLで画像の境界・変位・陰影を制御し、素材比較やHeroの切り替えへ組み込むインタラクティブ表現。

1件

マウス・インタラクション系

マウス・インタラクション系に関する実装記事です。

1件

ローディング系

ローディング系に関する実装記事です。

1件

関連記事