ブログ

Liquid Glass Design開発11 分で読めます

Liquid Glass の React ライブラリ比較(2026年)

Liquid Glass の React ライブラリ比較:liquid-glass-react、@samasante/liquid-glass、WebGL 系の仕組み、対応ブラウザ

Liquid Glass の React ライブラリ比較(2026年)
目次
  1. 各ライブラリがガラスを作る仕組み
  2. Liquid Glass の React ライブラリ
  3. liquid-glass-react
  4. @samasante/liquid-glass
  5. Liqui:当サイトのコンポーネントライブラリ
  6. WebGL 系の選択肢
  7. liquid-gooey:モーフィングの部分を担う
  8. 選び方
  9. Vue で Liquid Glass を使う
  10. 参考資料

React で Liquid Glass(リキッドグラス)を使うなら、主な選択肢は2つです。ガラス系で最もダウンロードされているコンポーネントで、Chromium でだけ背景を曲げる liquid-glass-react と、曲げるコンテンツを渡せば Chrome、Safari、Firefox で屈折させられる新しいヘッドレスなレンズ @samasante/liquid-glass です。ほかには、前者のフォーク、スクリーンショットをもとに描く WebGL レンダラー、そしてそもそもガラスではない、液体のように変形するライブラリがあります。

以下の数値はすべて、2026年11月14日時点の npm、GitHub、Bundlephobia のものです。「ダウンロード数」は、その日までの30日間の npm のダウンロード数を指します。

各ライブラリがガラスを作る仕組み

手法は3つあり、ブラウザ対応の違いはほぼすべてこれで説明がつきます。

  1. 要素の背後にあるページを読み取る SVG の変位フィルター(backdrop-filter: url()、または backdrop-filter のぼかしに重ねた filter: url())。ライブのコンテンツを曲げられますが、描画するのは Chromium だけです。Safari と Firefox では、平坦なぼかしにフォールバックします。
  2. コンポーネント自身が持つコンテンツに filter: url() で適用する SVG の変位フィルター。背景を一切読み取らないので、3つのエンジンすべてで動きます。難点は、曲げる対象のコピーをコンポーネントが自分で持っていなければならないことです。
  3. スクリーンショットや canvas の上に描く WebGL シェーダー。見た目の自由度はとても高いのですが、DOM からラスタライズしたものは、もう一度キャプチャするまで静止画のままです。

これらのパッケージが中で何をしているか知りたければ、当サイトの CSS と SVG による Liquid Glass のチュートリアルで、最初の2つを素のコードで紹介しています。

Liquid Glass の React ライブラリ

liquid-glass-react

Max Rovensky の Liquid Glass React(GitHub では rdev/liquid-glass-react)は、多くの人が最初に見つけるライブラリです。GitHub のスターは約6,700、直近30日の npm ダウンロード数はおよそ152,000です。

  • 手法1を使っています。コンポーネントは backdrop-filter のぼかしの上に SVG の feDisplacementMap フィルターを filter: url() で適用し、色収差のために変位のパスを3回実行します。Firefox では SVG フィルターを丸ごと省きます。README には、Safari と Firefox は「エフェクトに部分的にしか対応していない(変位は表示されない)」とあります。
  • props は displacementScale、blurAmount、saturation、aberrationIntensity、elasticity、cornerRadius と、mode(「standard」「polar」「prominent」「shader」のいずれか)です。README では shader モードを「最も正確だが、最も安定しているわけではない」と説明しています。
  • バージョンは 1.1.1、ライセンスは MIT、peer dependency は React 19 以降です。Bundlephobia の計測では gzip 後で約33 KB です。
  • 最後のコミットとリリースは2025年6月です。未解決の issue とプルリクエストは合わせて25件あり、その中に issue #20 があります。コンポーネントが常に translate(-50%, -50%) で中央寄せするので、通常のレイアウトの中に配置しにくいという問題です。

Chromium のユーザーが多いサイトや、マウスに追従する弾力のある動きが見せ場になるランディングページやデモに向いています。iPhone でも正しく表示されなければならない本番の UI なら、次のパッケージを検討してください。

@nkzw/liquid-glass はこのライブラリのフォークで、「スタイルの修正、TypeScript パッケージの修正、いくつかの簡略化」を加えたものです。React 18 以降に対応しています。最後のリリース(1.3.0)はこちらも2025年6月で、描画方式とブラウザについての注意書きも同じです。

@samasante/liquid-glass

Sam Asante のパッケージは、当サイトのリソースページに Real liquid glass for the web として載っています。ヘッドレスな <Glass> コンポーネントで、ボックスには自前の CSS や Tailwind でスタイルを付け、それをコンポーネントがマテリアルに変えます。

  • 手法2を使い、オプションで手法1も使えます。スタイルを付けたボックスを包むと、どのブラウザでもすりガラス化、ティント(色付け)、縁の光が加わります。背後のライブのページを曲げるのは Chrome と Edge だけで、これはその経路に backdrop-filter: url() が必要だからです。Safari と Firefox で曲げるには、レンズに自分の子要素を屈折させる(size と center を渡す)か、refract={<img src="/photo.jpg" />} を渡して、背後にあるもののコピーを曲げさせます。
  • <video> と <canvas> では WebGL に切り替えます。Safari は再生中の動画に SVG フィルターをかけないためです。
  • BROWSERS.md には Safari 向けの回避策が書かれています。WebKit ではスーパーサンプリングをしない、マップは形が変わったときだけ作り直す、そして WebKit はフィルターの出力を ID ごとにキャッシュするので更新のたびに新しいフィルター ID を使う、というものです。
  • バージョンは 0.1.1(2026年6月23日)、MIT、ランタイム依存はゼロ、peer は React 18 以降です。Bundlephobia の計測では gzip 後で約17 KB です。直近30日のダウンロード数はおよそ63,000、GitHub のスターは約670です。
  • リポジトリは、作成から約1時間後の2026年6月23日以降コミットがありません。依存する前に、バージョンを固定してソースを読んでおきましょう。

Liqui:当サイトのコンポーネントライブラリ

Liqui は当サイト自身のオープンソースプロジェクトなので、その点を踏まえてこの項目を読んでください。Base UI で作ったコンポーネント38種(ボタン、メニュー、セレクト、ダイアログ、スライダ、iOS 風のタブバー、それらと組み合わせるフォームコントロール)のセットで、shadcn CLI がソースコードとしてリポジトリに書き込みます。npm の依存は、屈折のカーネルである @liqui-design/glass の1つだけです。

  • Chromium では手法1、Safari と Firefox では手法2を使います。領域を LiquiBackdrop で包むと、ページそのものを屈折させられない環境では、その中のガラスの面がすべてその背景のコピーを曲げます。背景がわからない面や、ボックスの外にポータルで出したポップアップは、縁の光を保ったまますりガラスになります。
  • 変位マップは canvas に一度だけ描いてサイズと光学設定ごとにキャッシュし、フィルターはすべて共有の SVG レジストリ1つに置きます。そのため、同じボタンがいくつあってもマップは1枚で済みます。
  • @liqui-design/glass のバージョン 0.8.0 は2026年11月17日のリリースで、MIT、peer は React 18 または 19 です。コンポーネントには Tailwind CSS v4 が必要です。11月18日までの30日間の npm ダウンロード数は約5,000、GitHub のスターは約170です(2026年11月20日に確認)。
  • セットアップ、タブバー、Safari での詳細は、当サイトの React 用 Liquid Glass コンポーネントのガイドで解説しています。

WebGL 系の選択肢

@specy/liquid-glass-react は Three.js で描画します。React API に updateScreenshot() メソッドがあり、ガラスに映るのはページをキャプチャした画像で、その更新は自分で行います。Bundlephobia では gzip 後で約220 KB、最後のリリース(1.0.2)は2025年6月です。静的な背景の上のヒーロービジュアルなら問題ありませんが、変化するコンテンツの上に置く UI には向きません。

Charles Yin の Liquid Glass Studio は、コンポーネントライブラリというより MIT ライセンスのプレイグラウンドです。WebGL2 と WebGPU で作られていて、細かいコントロールがあります。リポジトリは2026年9月に更新されています。シェーダーでどこまでの見た目が出せるかを確かめたり、すでに描画している canvas のシーンの上にガラスを置く場合に計算部分を借りたりするのに向いています。

liquid-gooey:モーフィングの部分を担う

Jakub Antalik の Liquid Gooey は、レンズの部分は扱わず、見た目のうちモーフィングの側を担います。液体のように融合したり分かれたりする形で、「Morph」と「Move」のエフェクトがあります。液体状の形は SVG のシルエットレイヤーに描き、その上で実際の DOM をくっきり保ちます。README によると、フィルターをかけるのは SVG のコンテンツで、HTML に CSS の url() を使うことはありません。Safari でも正しく表示されるのはこのためです。バージョンは 0.2.2(2026年9月)、MIT、peer は React 18 以降、gzip 後で約17 KB、直近30日のダウンロード数は約318,000です。ボタンからメニューが芽吹くように出てくる動きを作りたいときは、ぼかしベースのガラスの面と組み合わせてください。

選び方

  1. iPhone と Safari のユーザーにも屈折を見せる必要があるなら、@samasante/liquid-glass を使い、要素自身の子要素か、渡したコピーを屈折させます。任意のライブのコンテンツの上に浮かぶパネルは、Chromium 以外ではすりガラスになるだけで曲がらないことは割り切るしかありません。
  2. shadcn/ui と Tailwind v4 の上でガラスのコンポーネント(メニュー、セレクト、ダイアログ、タブバー)を一式そろえたいなら、当サイトのライブラリである Liqui を使います。Safari と Firefox では LiquiBackdrop の中で屈折し、それ以外の場所ではすりガラスになります。
  3. ユーザーの大半がデスクトップの Chrome で、マウスに反応する弾力のあるコンポーネントをそのまま組み込みたいなら、liquid-glass-react で足ります。平坦なぼかしのフォールバックが完成した見た目になっているかを確かめ、配置のクセに対処する時間も見込んでおきましょう。
  4. 必要なのが数個のボタンやナビゲーションバーだけなら、依存を増やす必要はありません。当サイトのチュートリアルのフィルターとマップ生成のコードは数十行で、フォールバックも自分で制御できます。
  5. ガラスの下が canvas、3D シーン、動画なら、シェーダーを使います。動画なら @samasante/liquid-glass の WebGL モードも使えます。
  6. 本当に欲しいのが融合やモーフィングなら、liquid-gooey を使い、ガラス自体はシンプルにとどめます。

Sanoj Sunny のボリュームスライダのコンセプトは、どのライブラリを試すにもよい題材です。写真の上に透明なガラスのトラックがあり、レベル(52)はその中の2つ目のカプセルで、横には丸いボタンが浮かんでいます。これを Safari で再現するには写真のコピーを屈折させる必要があり、@samasante/liquid-glass なら refract prop でできますが、liquid-glass-react ではできません。

スピーカーを持つ手の暗い写真の上に浮かぶ、52を示す透明なガラスの音量スライダと、AirPlay 風の丸いボタン
Liquid Glass - Slider Concept(Volume)(sanoj sunny) ギャラリーで見る

Roman Vasylovskyi の Liquid glass navigation は、1つ目のルールで触れた難しいケースです。画面いっぱいの砂丘の写真の上にサイトのヘッダーが浮かび、バーの内側で稜線がはっきり曲がっています。固定のヒーロー画像の上なら、同じ写真を @samasante/liquid-glass に渡せます。ページがヘッダーの下でスクロールするようになると、どのライブラリを使っても、曲がりが見えるのは Chromium だけです。

暗い砂丘の上に置かれた、リンクと Get Started ボタンのあるガラスのナビゲーションバー。バーの背後で砂丘の稜線が曲がっている
Liquid glass navigation(Roman Vasylovskyi) ギャラリーで見る

どれを選んだ場合でも、prefers-reduced-transparency 用の不透明なフォールバックと、1ページに何枚までガラスのレイヤーを置けるかは、Web のパフォーマンスとフォールバックのガイドで解説しています。

Vue で Liquid Glass を使う

当サイトのリソースページにある Liquid Glass Vue は、WebGL で屈折を描画する Vue 3 と Vite のデモです。インストールして使うパッケージというより学習用のプロジェクトで、GitHub はリポジトリ内にライセンスファイルを検出していないので、商用の製品にコードを流用する前に作者に確認してください。コンポーネントとして使うなら、npm の liqvued(MIT、2026年7月のバージョン 0.2.1、Vue 3.5 以降)が Chromium では backdrop-filter: url() を使い、ドキュメントによると Safari と Firefox ではぼかしにフォールバックします。

バージョン、設定、数値は2026年11月14日時点で確認したものです。

参考資料

更新

この記事をシェア

毎週、新しい参考例をお届け

厳選した Liquid Glass の作例を、実装方法とあわせてお届けします。

週に1通、英語での配信です。購読解除はワンクリックで。