Liquid Glass Design開発9 分で読めます
Liquid Glass の CSS・SVG コード:本物の屈折を再現
Web 向け Liquid Glass のコード:全ブラウザで動く CSS のガラスと、Chromium で本物の屈折を出す SVG feDisplacementMap フィルター

目次
Web で Liquid Glass(リキッドグラス)を作るコードは、2つの部品でできています。ひとつは、ぼかし、ティント(色付け)、縁のハイライト、光沢をまとめた CSS のガラスレイヤーで、どのブラウザでも動きます。もうひとつは、要素の背後にあるピクセルを曲げる SVG の feDisplacementMap フィルターです。2026年11月時点では、曲げる部分は Chromium 系ブラウザの backdrop-filter: url() 経由でしか描画されないので、CSS レイヤーの上に重ねる拡張として扱ってください。
backdrop-filter のぼかしだけではグラスモーフィズムに見える理由
backdrop-filter: blur() は、パネルの背後にあるものを一様にぼかします。これは、2020年からデザイナーがグラスモーフィズム(glassmorphism)と呼んできた、すりガラス風カードの見た目です。Apple のマテリアルは、むしろ厚いレンズに近いふるまいをします。平らな中央部分では背景がかなりシャープなまま見え、丸みのある縁で曲がり、光が当たる側の縁にハイライトが乗ります。この違いは当サイトの Liquid Glass とは何かの解説で詳しく説明していて、Liquid Glass とグラスモーフィズムの比較記事には、スクリーンショットで両者を見分けるためのチェックリストがあります。コードの話に絞って言えば、ぼかしで得られるのはすりガラスの質感で、「liquid」らしさは縁での変位から生まれます。
動きのある作例は、Piqo Studio の Liquid Glass Design Video と Ho3ein の Liquid Glass Buttons hover effect で見られます。前者について、スタジオは Liquid Glass を Web に持ち込むものだと説明しています。


レイヤー1:すべてのブラウザで動く Liquid Glass の CSS
このレイヤーはすべての訪問者に表示されるので、屈折がなくても完成した見た目になっている必要があります。薄いティント、彩度を上げた小さめのぼかし、上端に沿った内側のハイライト、極細のボーダー、疑似要素による柔らかな光沢です。
.glass {
position: relative;
border-radius: 40px;
color: #fff;
background: rgb(255 255 255 / 0.10);
-webkit-backdrop-filter: blur(6px) saturate(160%);
backdrop-filter: blur(6px) saturate(160%);
box-shadow:
inset 0 1px 0 rgb(255 255 255 / 0.6), /* lit top rim */
inset 0 -1px 0 rgb(255 255 255 / 0.15), /* faint bottom rim */
inset 0 0 0 1px rgb(255 255 255 / 0.2), /* hairline edge */
0 10px 30px rgb(0 0 0 / 0.25); /* lift off the page */
}
.glass::before {
content: "";
position: absolute;
inset: 0;
border-radius: inherit;
pointer-events: none;
background: radial-gradient(120% 70% at 25% 0%, rgb(255 255 255 / 0.35), transparent 55%);
}-webkit- の行は残してください。MDN の互換性データによると、Safari は Safari 9 から、プレフィックスなしのプロパティが入った Safari 18 まで、プレフィックス付きのプロパティにしか対応していませんでした。古いバージョンの Safari はいまも使われています。
ぼかしは小さく抑えます。半径を大きくするとすりガラスに逆戻りし、レイヤー2の屈折で曲げるためのシャープな像が残りません。
同じクラスは <button> にも使えます。ホバー、押下時、フォーカスの各状態は、当サイトの Liquid Glass ボタンのガイドで追加しています。
レイヤー2:SVG の屈折フィルター
feDisplacementMap は、入力の各ピクセルを、2枚目の画像である変位マップから読み取った量だけ動かします。Filter Effects の仕様では P'(x,y) ← P(x + scale * (XC(x,y) - .5), y + scale * (YC(x,y) - .5)) と定義されています。赤が横方向、緑が縦方向の移動を制御します。チャンネルの値が128(0.5)なら「動かさない」という意味で、scale はピクセル単位の最大移動量です。
つまり、形の平らな中央部分ではニュートラルなグレー、縁の近くでは縁の法線方向にピクセルを押し出すマップを描けばよいわけです。フィルターは次のとおりです。
<svg width="0" height="0" aria-hidden="true" style="position:absolute">
<filter id="lg-refract" x="0" y="0" width="100%" height="100%"
color-interpolation-filters="sRGB">
<feImage id="lg-map" x="0" y="0" preserveAspectRatio="none" result="map" />
<feDisplacementMap in="SourceGraphic" in2="map" scale="60"
xChannelSelector="R" yChannelSelector="G" />
</filter>
</svg>
<div class="glass">Liquid Glass</div>color-interpolation-filters="sRGB" は削らないでください。このプロパティの初期値は linearRGB で、仕様ではマップの入力(in2)に適用されます。リニア空間ではニュートラルのはずの128が0.5でなくなり、ガラスの下のものがすべて中心からずれます。
マップ自体は canvas で生成するのがいちばん簡単です。次の関数は角丸長方形までの符号付き距離を使うので、カプセル、カード、円のどれにも使えます。
function makeDisplacementMap(w, h, r, bezel) {
const canvas = document.createElement("canvas");
canvas.width = w;
canvas.height = h;
const ctx = canvas.getContext("2d");
const img = ctx.createImageData(w, h);
// Signed distance to a rounded rectangle: negative inside, positive outside.
const sdf = (x, y) => {
const qx = Math.abs(x - w / 2) - (w / 2 - r);
const qy = Math.abs(y - h / 2) - (h / 2 - r);
return Math.hypot(Math.max(qx, 0), Math.max(qy, 0)) + Math.min(Math.max(qx, qy), 0) - r;
};
for (let y = 0; y < h; y++) {
for (let x = 0; x < w; x++) {
const inset = -sdf(x, y); // distance in from the edge
let dx = 0, dy = 0;
if (inset > 0 && inset < bezel) {
const nx = sdf(x + 1, y) - sdf(x - 1, y); // gradient points outward
const ny = sdf(x, y + 1) - sdf(x, y - 1);
const len = Math.hypot(nx, ny) || 1;
const t = 1 - inset / bezel; // 1 at the rim, 0 where the flat top starts
const strength = t * t;
dx = (-nx / len) * strength; // sample toward the center near the rim
dy = (-ny / len) * strength;
}
const i = (y * w + x) * 4;
img.data[i] = 128 + dx * 127;
img.data[i + 1] = 128 + dy * 127;
img.data[i + 2] = 128;
img.data[i + 3] = 255;
}
}
ctx.putImageData(img, 0, 0);
return canvas.toDataURL();
}bezel は、縁から内側のどこまで曲がりが及ぶかを表します。2乗で減衰させることで中央は平らに保たれ、いちばん強い曲がりが縁のすぐそばに来ます。Kube.io の CSS と SVG による屈折の記事はさらに踏み込み、いくつかの表面形状についてスネルの法則からカーブを導いています。ボタンやバーなら、ここで使った単純なカーブで十分です。
レイヤー3:描画できる環境だけで屈折をオンにする
.glass.is-refracting {
backdrop-filter: url(#lg-refract) blur(1px) saturate(160%);
}const isChromium =
navigator.userAgentData?.brands?.some((b) => b.brand === "Chromium") ?? false;
const glass = document.querySelector(".glass");
if (isChromium) {
const { width, height } = glass.getBoundingClientRect();
const map = document.getElementById("lg-map");
map.setAttribute("width", width);
map.setAttribute("height", height);
map.setAttribute("href", makeDisplacementMap(Math.round(width), Math.round(height), 40, 24));
glass.classList.add("is-refracting");
}@supports を使わずにスクリプトで判定する理由は2つあります。1つ目は、url() が backdrop-filter の有効な構文であることです(MDN にも載っています)。そのため、実際には何も描画しないブラウザでもパーサーはこれを受け入れますし、@supports が確かめるのはパーサーの判断だけです。2つ目は、MDN によると navigator.userAgentData が Chromium だけの API であることです。このおかげで、ブランドの判定は手軽で、そこそこ信頼できる目安になります。
マップは要素のサイズと一致している必要があります。要素のサイズが変わったら作り直し、その処理はデバウンスしてください。ピクセルごとのループにはそれなりのコストがかかるからです。
2026年11月時点で backdrop-filter: url() が動くブラウザ
- デスクトップと Android の Chrome、Edge、Opera、Brave などの Chromium 系ブラウザは描画します。
- Safari は描画しません。WebKit のバグ 245510「backdrop-filter: url(#some-svg-filter) doesn't work with SVG filters like feDisplacementMap」は、2022年9月からオープンのままです。2026年7月から9月にかけてコントリビューターがテスト付きのパッチを投稿しましたが、この記事の執筆時点でもステータスは NEW のままでした。
- Firefox は
backdrop-filterのurl()フィルターを受け付けます(Firefox 121 でリグレッションの修正が入りました)。ただし対象は、GPU レンダラーが描けるフィルターだけです。Mozilla のエンジニアはバグ 1972363 で、バックドロップの経路は「GPU アクセラレーションのないフィルターの描画に対応していない」と説明しています。feImageとfeDisplacementMapの組み合わせはこれに当たるので、エラーも出ずに効果だけが消えます。 - iPhone と iPad のブラウザは、Apple が EU で認めている代替エンジンを使うものを除いてすべて WebKit なので、iOS の Chrome でも屈折は出ません。
Safari と Firefox でも屈折させたい場合
要素自身が持つコンテンツに filter: url() で適用するなら、変位は3つのエンジンすべてで動きます。Chromium に限られるのは、バックドロップの経路だけです。当サイトのリソースページに Real liquid glass for the web として載せている Sam Asante のヘッドレスな React 製レンズと、Aave の記事「Building Glass for the Web」は、この方法を採っています。その代わり、屈折させるのはガラスの背後にあるもののコピー(画像、ヒーロー、スライダのトラック)になり、浮いているパネルの下にあるライブのページそのものは曲げられません。どちらの資料も Safari 固有の回避策を紹介しています。Safari はフィルターの出力をフィルター ID ごとにキャッシュするので、更新のたびに ID を変える必要があります。また Safari は、再生中の <video> には SVG フィルターをかけません。
当サイト自身のオープンソースの React ライブラリ Liqui は、この方法をコンポーネントにまとめたものです。LiquiBackdrop の中では、ガラスの面はすべて、Safari と Firefox ではその背景のコピーを、Chromium ではライブのページを屈折させます。その外では、面はすりガラスになります。セットアップは React 用 Liquid Glass コンポーネントのガイドで解説しています。
Chromium の経路を既製のコードで済ませたいなら、Shu Ding の Liquid Glass SVG filters があります。コピー&ペーストで使えるコードで、同じ feImage と feDisplacementMap の組を JavaScript から組み立てます。React を使っているなら、当サイトの Liquid Glass の React ライブラリ比較で、選択肢を方式ごとに整理しています。
公開前のチェックリスト
- 屈折をオフにしても、ガラスが読みやすいこと。Safari と Firefox の訪問者が見るのは、レイヤー1だけです。
- ガラスの上のテキストが、ヒーロー画像の上だけでなく、置かれうる最もごちゃついた背景の上でもコントラストの基準を満たしていること。
- フィルターに
color-interpolation-filters="sRGB"が付いていること。 - 変位マップが要素のサイズと一致していて、作り直すのはリサイズ時だけ(毎フレームではない)になっていること。
- 屈折のオンとオフを、
@supportsに頼らずスクリプトの判定で切り替えていること。 prefers-reduced-transparencyとprefers-contrast: moreのための不透明なフォールバックがあること。そのための段階的な CSS は、Web のパフォーマンスとフォールバックのガイドにあります。- ガラスをすべてのカードに使わず、いくつかのコントロールにとどめていること。
backdrop-filterは、1つごとに背後を読み直してフィルターをかけます。
scale と bezel を調整する前に、デザイナーが同じ問題をどう解いたかを見ておくと参考になります。Voicu Apostol の Liquid Glass Switch は Figma の Glass エフェクトで作られていて、つまみはトラックより背の高い透明なレンズです。明るい縁は細く、ティントはほとんどなく、つまみが重なったところではトラックの縁がはっきり曲がっています。このくらい小さなベゼルと明るい縁なら、コントロールの中央にあるものはゆがみません。

バージョン、設定、数値は2026年11月14日時点で確認したものです。
参考資料
- https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter
- https://github.com/mdn/browser-compat-data/blob/main/css/properties/backdrop-filter.json
- https://github.com/mdn/browser-compat-data/blob/main/api/Navigator.json
- https://developer.mozilla.org/en-US/docs/Web/CSS/@supports
- https://drafts.csswg.org/filter-effects-1/#feDisplacementMapElement
- https://kube.io/blog/liquid-glass-css-svg/
- https://bugs.webkit.org/show_bug.cgi?id=245510
- https://bugzilla.mozilla.org/show_bug.cgi?id=1868479
- https://bugzilla.mozilla.org/show_bug.cgi?id=1972363
- https://developer.apple.com/support/alternative-browser-engines/
- https://aave.com/design/building-glass-for-the-web
- https://github.com/samasante/liquid-glass
- https://github.com/shuding/liquid-glass
更新