博客

Liquid Glass Design开发阅读约 6 分钟

Liquid Glass 代码:用 CSS 和 SVG 做出真正的折射

Liquid Glass 网页代码:所有浏览器都能用的 CSS 玻璃层,加上在 Chromium 里做出真正折射的 SVG feDisplacementMap 滤镜。

Liquid Glass 代码:用 CSS 和 SVG 做出真正的折射
本文目录
  1. 为什么只用 backdrop-filter blur 看起来像 glassmorphism
  2. 第 1 层:所有浏览器都能用的 Liquid Glass CSS
  3. 第 2 层:SVG 折射滤镜
  4. 第 3 层:只在能渲染的地方开启折射
  5. 2026 年 11 月,backdrop-filter: url() 在哪些地方能用
  6. 如果 Safari 和 Firefox 也要折射
  7. 上线前的检查清单
  8. 参考来源

网页上的 Liquid Glass 代码分两部分:一层 CSS 玻璃(模糊、染色、边缘高光、光泽),所有浏览器都能显示;再加一个 SVG feDisplacementMap 滤镜,把元素后面的像素扭弯。到 2026 年 11 月,扭弯这部分只有 Chromium 浏览器能用 backdrop-filter: url() 渲染出来。所以要把它当成叠在 CSS 层上的增强效果。

为什么只用 backdrop-filter blur 看起来像 glassmorphism

backdrop-filter: blur() 会把面板后面的东西均匀抹开。这就是设计师从 2020 年起叫作 glassmorphism(毛玻璃风格)的磨砂卡片效果。Apple 的材质更像一块厚透镜:平坦的中间部分背景基本清晰,到圆角边缘才弯折,朝光的那条边上还有一道高光。我们的 Liquid Glass 介绍文章把两者的区别讲得更细,Liquid Glass 与 glassmorphism 对比里还有一份截图检查清单,教你分辨两者。落到代码上,简单说就是:模糊只能给你磨砂感,「liquid」那种液态感来自边缘的位移。

想看动起来的例子,可以看 Piqo Studio 的 Liquid Glass Design Video,工作室说这个作品是把 Liquid Glass 带到网页上;还有 Ho3ein 的 Liquid Glass Buttons hover effect。

Piqo Studio 网站的手机画面:半透明的胶囊形页头和 Book a call 按钮浮在一张书桌照片上
Liquid Glass Design Video by Piqo Studio。 在图库中查看
白色背景上的浅蓝色胶囊按钮,写着 Start Now,右边有一个箭头
Liquid Glass Buttons - Hover Effect by Ho3ein。 在图库中查看

第 1 层:所有浏览器都能用的 Liquid Glass CSS

每个访客都会看到这一层,所以它在没有折射的情况下也得是完成品:浅浅的染色,一点模糊加额外饱和度,顶边一道内阴影高光,一圈细线边框,再用伪元素加一层柔和的光泽。

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 层的折射也没有清晰的东西可扭。

同一个 class 放到 <button> 上也能用。我们的 Liquid Glass 按钮指南补上了 hover、按下和焦点状态。

第 2 层:SVG 折射滤镜

feDisplacementMap 会按第二张图(位移贴图)里读到的数值,移动输入图像的每个像素。Filter Effects 规范的定义是 P'(x,y) ← P(x + scale * (XC(x,y) - .5), y + scale * (YC(x,y) - .5))。红色通道控制水平移动,绿色通道控制垂直移动。通道值 128(0.5)表示「不动」,scale 是最大位移的像素数。

所以要做的事情是画一张贴图:形状平坦的中间部分是中性灰,靠近边缘的地方沿边缘法线方向推动像素。滤镜如下:

HTML
<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 生成最省事。下面这个函数用的是到圆角矩形的有向距离(signed distance),所以胶囊形、卡片和圆形都能用:

JavaScript
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 决定弯折从边缘往里延伸多远。平方衰减让中间保持平坦,最强的弯折落在边缘上。Kube.io 那篇讲用 CSS 和 SVG 做折射的文章走得更远,它按斯涅尔定律为不同的表面轮廓推导曲线;做按钮和工具栏的话,这条简化曲线已经够用。

第 3 层:只在能渲染的地方开启折射

CSS
.glass.is-refracting {
  backdrop-filter: url(#lg-refract) blur(1px) saturate(160%);
}
JavaScript
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,原因有两个。第一,url() 是 backdrop-filter 的合法语法(MDN 有列出),所以那些最后什么都画不出来的浏览器,解析器也照样接受它,而 @supports 只问解析器。第二,按 MDN 的说法,navigator.userAgentData 是 Chromium 独有的 API,拿 brand 来判断,成本低,结果也比较可靠。

贴图尺寸必须和元素一致。元素尺寸变了就要重新生成,并且做防抖,因为逐像素循环是有开销的。

2026 年 11 月,backdrop-filter: url() 在哪些地方能用

  • 桌面端和 Android 上的 Chrome、Edge、Opera、Brave 以及其他 Chromium 浏览器能渲染。
  • Safari 不行。WebKit bug 245510「backdrop-filter: url(#some-svg-filter) doesn't work with SVG filters like feDisplacementMap」从 2022 年 9 月开到现在。2026 年 7 月到 9 月之间有贡献者提交了带测试的补丁,但写这篇文章时,这个 bug 的状态还是 NEW。
  • Firefox 接受 backdrop-filter 里的 url() 滤镜(Firefox 121 修复了一个回归问题),但只限于它的 GPU 渲染器能画的滤镜。一位 Mozilla 工程师在 bug 1972363 里解释说,backdrop 这条路径「不支持绘制没有 GPU 加速的滤镜」(doesn't support drawing non-GPU-accelerated filters),feImage 加 feDisplacementMap 正好属于这一类,所以效果会悄无声息地失效。
  • iPhone 和 iPad 上的浏览器全都是 WebKit 内核,除非是 Apple 在欧盟允许的其他引擎,所以 iOS 上的 Chrome 也不会折射。

如果 Safari 和 Firefox 也要折射

用 filter: url() 把位移作用到元素自己的内容上,三个引擎都支持。只有 backdrop 这条路径限定在 Chromium。Sam Asante 的 headless React 透镜用的就是这个思路,我们的资源页把它收录为 Real liquid glass for the web;Aave 的文章「Building Glass for the Web」也是这么做的。代价是:你折射的是玻璃后面内容的一份副本(一张图片、一个 hero 区、一条滑块轨道),浮动面板下面实时的页面内容折射不到。这两个来源都提到了 Safari 专用的绕法:Safari 按滤镜 ID 缓存滤镜输出,所以每次更新都得换 ID;另外 Safari 不会对实时播放的 <video> 应用 SVG 滤镜。

我们自己的开源 React 库 Liqui 把这个思路封装成了组件。在 LiquiBackdrop 内部,每个玻璃表面在 Safari 和 Firefox 里折射这个背景的一份副本,在 Chromium 里折射实时页面;放在它外面,表面就是磨砂效果。具体怎么配置,见我们的 React 版 Liquid Glass 组件指南。

想要 Chromium 方案的现成版本,可以用 Shu Ding 那套能直接复制粘贴的 Liquid Glass SVG filters,它用 JavaScript 搭出同样的 feImage 和 feDisplacementMap 组合。如果你用 React,我们的 Liquid Glass React 库对比按实现思路把各个方案分了类。

上线前的检查清单

  • 关掉折射后玻璃依然好看。所有 Safari 和 Firefox 访客只能看到第 1 层。
  • 玻璃上的文字放在它可能出现的最花的背景上也能通过对比度检查,别只拿 hero 图测。
  • 滤镜带有 color-interpolation-filters="sRGB"。
  • 位移贴图和元素尺寸一致,在 resize 时重新生成,别每帧都生成。
  • 用脚本检测来控制折射开关,别用 @supports。
  • 为 prefers-reduced-transparency 和 prefers-contrast: more 准备不透明的回退样式。网页性能与回退指南里有分级的 CSS 写法。
  • 玻璃只用在少数几个控件上,别每张卡片都用。每个 backdrop-filter 都要重新读取并处理它后面的内容。

调 scale 和 bezel 之前,先看看设计师怎么处理同一个问题。Voicu Apostol 用 Figma 的 Glass 效果做了 Liquid Glass Switch,里面的滑块是一块比轨道还高的透明透镜,只有一圈细细的亮边,几乎没有染色;滑块压住轨道的地方,能明显看到轨道边缘被弯折。像这样用小 bezel 加亮边,控件中间的内容就不会变形。

深色开关,标签写着 Dark,透明玻璃滑块比轨道高出一截,压住的轨道边缘被弯折
Liquid Glass Switch by Voicu Apostol。 在图库中查看

版本、设置和数据核对于 2026 年 11 月 14 日。

参考来源

更新于

分享这篇文章

每周更新,精选新参考

精选 Liquid Glass 作品,每一个都附上实现方式。

一周一封,英文内容,一键退订。