Communitygithub.com

Liquid Glass · 全機能実装

Apple WWDC25 の Liquid Glass を完全再現する単一ファイルの WebGL 実装。26 のマテリアル特性と 82 のインタラクション(クリック/ダブルクリック/長押し/右クリック/ドラッグ/慣性/ゴースト/展開・収納/分離・結合/融合/キーボード/アクセシビリティ/スクロール端)をサポート。

Liquid Glass · 全機能実装 とは?

このスキルは、Apple WWDC25 で発表された Liquid Glass の全機能を単一の HTML ファイルに実装した WebGL ベースのプロフェッショナル用ツールです。フラグメントシェーダー内でガラスの屈折、厚み、フレネル効果、分散、リム、内部発光をすべて計算し、DOM はテキスト、ボタン、シャドウのみを担当します。対応するアクションは 9 カテゴリ 82 種類に及び、ポインター操作、ドラッグ慣性、モーフィング、押下フィードバック、光学アニメーション、アダプティブ動作、システム/アクセシビリティ、コントロール、キーボードショートカットを網羅。シェーダーをゼロから書く必要はなく、付属の `liquid-glass-all.html` を改変するだけで最短 1 分で効果を確認できます。独立した GPU パイプラインを持たない環境向けに、CSS フォールバックを含む段階的機能低下(プログレッシブ・デグラデーション)チェーンも実装。付属の `?selftest=1` クエリで 13 項目の自動テストを実行でき、ヘッドレス Chrome によるスクリーンショット撮影で動作の正しさを検証可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cyt-56/liquid-glass-webgl/tree/HEAD/skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Liquid Glass · 全機能実装 は何をしますか?

単一ファイルの WebGL 実装。ガラスの屈折、厚み、フレネル効果、分散、リム、内部発光をすべてフラグメントシェーダーで計算し、DOM はテキスト、ボタン、ドロップシャドウのみを担当。 シェーダーをゼロから書かないこと:90 行で動作しますが、400 行をゼロから書くのは成功率が極めて低いです。liquid-glass-all.html を改変してください。

0. 最速パス(1 分で効果を確認)

  1. Chrome / Edge で liquid-glass-all.html を開きます。
  2. 右側のコントロールパネルには 5 つのスライダー(屈折 / 倍率 / リム / 分散 / 着色)と 4 つのプリセットボタンがあり、変更するとすぐに変化が反映されます。
  3. すべてのアクションが含まれています:カプセルをクリックして展開、押しながらドラッグ、長押しでバブル表示、右クリックで別のメニュー、ダブルクリックで浮上、Dock 分離キー、キーボードスペース/S/W/Esc。
  4. 検証は内蔵のセルフテストを使用:URL に ?selftest=1 を追加すると、ページ左上に 13 個の PASS / FAIL が直接表示されます。
  5. スクリーンショット撮影:?pose=1 で「展開+分離+バブル」を一度にセットアップ;?pose&wire=1 で光路診断フィールドを重ねて表示。
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
  --window-size=1280,800 --screenshot=out.png "file:///<絶対パス>/liquid-glass-all.html?selftest=1"

スクリーンショットを実際に確認し、左上が FAIL 0 であることを確認してください。コードだけを見て完了したと判断しないでください。

1. アセット

liquid-glass-all/
├── SKILL.md                       # このファイル:パス、アクション、光路、落とし穴、検証
├── liquid-glass-all.html          # 全機能実装(唯一の実行成果物)
└── references/
    ├── action-matrix.md           # 82 アクションの完全テーブル(トリガー / 変更内容 / パラメータ / 逆操作)
    ├── feature-matrix.md          # 26 マテリアル特性 × 本実装の対応状況
    ├── optics-model.md            # 光路物理モデルと定数(シェーダー記述前に必読)
    └── interaction-playbook.md    # ステートマシン、タイミング、ヒットテスト、検証

2. 82 アクションクイックリファレンス(9 カテゴリ)

完全なテーブルは references/action-matrix.md にあり、ここでは骨格のみを示します:

カテゴリ数内容
A ポインター13ホバー侵入/移動/離脱、近傍減衰、プレス、リリース、シングルクリック、ドラッグ開始/追従/スプリングバック、端クランプ、右クリックメニュー、長押しメニュー
B ドラッグ慣性6方向伸張、弾性移動、変形減衰、慣性スライド、ドラッグ浮上、遅延ゴースト
C モーフィング10展開/収納、メニュー項目フェードイン、角丸追従、分離/右片突き出し/結合、分割アクセント、ゼロ幅スキップ、融合接続ネック
D 押下フィードバック8収縮、屈折増強、厚み増加、内部発光、隣接パネル波及、底アーク輝度上昇、方向ハイライト、フラッシュ誘導
E 光学アニメーション83 種類の屈折モード、バリアント切り替え、着色マッピング、明暗反転、環境オーバーフロー色、アダプティブシャドウ、フォーカス喪失フェードアウト、背景光斑漂動
F アダプティブ7輝度/主色サンプリング、背景アップロード、アダプティブ解像度、光路更新、DPR 上限、機能低下チェーン
G システムとアクセシビリティ8リサイズ再配置、スクロール soft/hard、3 つのアクセシビリティスイッチ、ウィンドウフォーカス喪失、Tab フォーカスリング、スクリーンリーダーセマンティクス
H コントロール8メイン操作ボタン、5 スライダー、バリアントセグメント、モード 3 ボタン、4 スイッチ、4 プリセット、分離キー、展開ヘッダー
K キーボード7Space / S / W / Esc / Tab / ↑↓ / Enter

アクションモニターバーはページ下部に表示:各アクションを記録し、最新 4 つを表示します。これにより「このアクションは本当にトリガーされたのか」を確認できます。

3. 光路の 7 ステップ(順序変更不可)

  1. 輪郭:sdRoundBox で符号付き距離 d を取得;x = clamp(-d/band, 0, 1)、0=輪郭、1=中心、band = max(5, min(hx,hy)*0.30)。
  2. 凸面高さフィールド:H(x)=sqrt(1-(1-x)²)、H'(x)=v/sqrt(1-v²)(v=clamp(1-x,0.02,0.9995))。pow ではなく sqrt を使用。
  3. 入射角:sinI = min(H'/sqrt(1+H'²), 0.62)、thT = asin(sinI/1.5168)。0.62 はハード上限。0.93 にすると端が 200px 級に押し出され、全体が暗くなります。
  4. 厚み:tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg、vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y))(下厚上薄)。
  5. 変位:off = -dir*tan(thI-thT)*tpx*refract*Tf、さらに端の補正項を追加;最後に clamp(off,-10,10)。
  6. 焦点/リム:focal = mag*magMul*(0.50*cW - 0.40*eW);1-focal は常に正である必要があります。そうしないと局所的に 180° 反転し、文字が逆さまになります。magMul はパネル別:lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80。
  7. 合成:sp = c + rel*(1-focal) - off;RGB を ±disp*7*eW で分離してサンプリング;さらに着色による輝度圧縮 0.58*L+0.133、環境オーバーフロー色 0.10、フレネルリム、乳白色、上部鏡面、底部アーク、内部発光。

テクスチャの Y 軸は反転させる必要があります:uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y)。この行がないと、ミラー画像と逆さまの文字になります。

4. ステートマシンと主要閾値

アクション閾値 / パラメータ
hoverパネル内;パネル外 180px 以内では fade で減衰
presspress→1(k=0.19/フレーム)、scale 0.965、屈折 ×1.3、底アーク ×1.75
シングルクリックpointerup かつ変位 ≤4px → 240ms 遅延してトリガー。ダブルクリックとの競合を回避
ダブルクリック2 回の pointerdown 間隔 <300ms、2 回目の down で即座にシングルクリックタイマーをキャンセル
長押しpointerdown 後 500ms、移動 >4px でキャンセル;進捗ドットをタッチ点で拡大
ドラッグ変位 >4px でドラッグに移行;clamp で 8px の内側余白
慣性リリース時の速度 >6px/イベント → v*1.05 で開始、毎フレーム ×0.94、<1px で終了しスナップ
展開136×48 → 236×296、底辺は不動:ty = lay.y + lay.h - 296;メニュー項目は高さ 110→250 でフェードイン、過半で pointerEvents を有効化
分離Dock 300 → 左 140;右片 tx を lay.x + lay.w - 140 に固定、幅 0→140
結合右片は幅を先に収縮、位置は不動(「滑り出る」のを防ぐ)
融合分離後、2 つのピース間に 20px の隙間を維持、リムが相互に呼応;真のメタボール和集合には SDF smooth-min が必要だが、Web 単一パス版では未実装
スプリング位置 ω=15、幅 ω=18.5、ζ=0.66、dt=1/60 → 約 0.45s、6% オーバーシュート

5. パラメータプリセット

狙いrefractmagrimdisptintthick
厚いガラスのカプセル1.200.350.950.220.24✓
レンズで彩条を押しつぶす1.500.601.000.180.10✓
厚いガラス蓋の小文字1.250.420.800.300.16✓
トップナビゲーション(控えめ)0.900.200.600.150.10✗
コントロールパネル(可読性重視)1.000.150.550.120.14✗

調整順序:refract で変位 → mag でリム → rim で端 → disp/tint で質感。逆順にすると必ずパラメータ同士が干渉します。

6. 絶対にハマる 8 つの落とし穴

  1. uniform 配列が信頼できない:uGeo[12] は ANGLE/D3D 上で代入してもエラーにならないが、値が反映されない → パネルごとに 1 回の draw call。
  2. ループ内の uniform 分岐は最適化で消える:ループ内では mix / step を使った分岐のない記述を推奨。
  3. 宣言されても未使用の uniform は最適化で消去され、getUniformLocation が null を返し、uniform 不足と誤報告される。
  4. gl.getUniform(prog, null) は TypeError をスローし、その後のコードはすべてスキップされる(フリーズしたように見える)。
  5. テクスチャ Y 軸:反転しないとミラー画像+逆さま文字。
  6. click のみのバインドではイベントが欠落する:pointerdown + pointerup + 変位閾値 を使用。
  7. half は GLSL ES の予約語:vec2 half と書くとコンパイルエラーになり、ログには syntax error としか表示されない。同様の危険語:filter / input / output / long / short / packed。
  8. 逆順の smoothstep は未定義動作:smoothstep(1.0,-1.0,d) はマシンが変わると結果が異なる。必ず 1.0 - smoothstep(小, 大, x) と記述。

さらにアクション層固有の落とし穴:

  • 長押し後のリリースはシングルクリックと見なさない(longFired フラグが必要)。そうしないと、長押しメニューを開いた直後に展開が発生する。
  • 右クリックは pointerdown の前にブロックする(e.button !== 0 で即 return)。そうしないと、右クリックがドラッグを開始してしまう。

7. 検証(変更のたびに実行)

?selftest=1 は 13 項目をカバー:シングルクリック展開/収納、長押しバブル、Esc でバブル消去、右クリックで別のメニュー、Dock 分離と結合、融合ネック、方向キー選択、Esc で全体収納、ダブルクリック浮上、慣性、W 光路場。

さらに手動で確認:

  • ガラス内部のコンテンツの向きが正しい(逆さま、ミラーなし)
  • 端一周のリム、上部鏡面、底部輝線アークがすべて揃っている
  • 暗い背景でもガラス内部が真っ黒になっていない(もやっとしたグレーがある)
  • ドラッグ時にゴーストが遅れて追従し、リリース時に慣性が働いてからスナップする
  • 分離時は「裂ける」ように見え、「引き離される」ようには見えない
  • スクロールテキストが端でフェードアウトし、端まで来るとハードな髪の毛のような線に切り替わる
  • 3 つのアクセシビリティスイッチがすべて機能する(透明度低下 / コントラスト強化 / モーション抑制)

8. パフォーマンス予算

項目予算
同画面のガラス≤10 個(本実装は 10 個、必要に応じて出現する幅 0 のバブル/ブリッジを含む)
draw call2 つの program + 各ガラスにつき 1 回の AABB draw
背景アップロード5 フレームに 1 回;静止時は 8 フレームに 1 回
輝度サンプリング10 フレームに 1 回、w*h>24000 のパネルのみサンプリング
レンダリング倍率<42fps → 0.72、>56fps → 1.0、DPR 上限 2
機能低下チェーンパネル削減 → 倍率低下 → アップロード頻度低下 → 分散オフ → CSS 版にフォールバック

9. レッドラインとプラットフォーム境界

  • ガラスはナビゲーション層のみに適用;コンテンツ層にはガラスを敷かない。
  • ガラスの重ね掛けは禁止(屈折の参照を失い、汚れのように見える);Regular と Clear は同じ画面で混用しない。
  • 着色はメイン操作のみに適用;ハイライトは控えめに、rim > 1.2 は不自然に見える。
  • Web ではできないこと:ガラス上のテキスト/アイコンは自身の屈折を受けられない(iOS 26 のシステム合成パイプラインが必要);CSS フォールバックではピクセル単位のレンズリムと分散は再現できない。
  • 自描画版では未対応:真のメタボール和集合(本実装では細いネックで近似)、デバイス傾きによる照明、リアルタイムビデオのフレーム単位の主色統計。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル