博客

Liquid Glass Design开发阅读约 8 分钟

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,主要是二选一。一个是下载量最大的玻璃组件 liquid-glass-react,它只在 Chromium 里扭曲背景;另一个是较新的 headless 透镜 @samasante/liquid-glass,只要你把要扭曲的内容交给它,它在 Chrome、Safari 和 Firefox 里都能折射。其余几个分别是第一个库的 fork、基于截图工作的 WebGL 渲染器,以及一个做液态形变的库,后者根本算不上玻璃。

下面所有数字都取自 2026 年 11 月 14 日的 npm、GitHub 和 Bundlephobia。「下载量」指截至当天前 30 天的 npm 下载量。

这些库怎么做出玻璃

一共三种技术,浏览器支持上的差别几乎都能用它们解释。

  1. 用 SVG 位移滤镜读取元素后面的页面(backdrop-filter: url(),或者在 backdrop-filter 模糊上面再叠一个 filter: url())。这种方式扭曲的是实时内容,但只有 Chromium 画得出来。Safari 和 Firefox 会退回到普通的平面模糊。
  2. 用 filter: url() 把 SVG 位移滤镜作用到组件自己持有的内容上。它从不读取 backdrop,所以三个引擎都能用。问题在于,组件手里必须有一份它要扭曲的内容的副本。
  3. 用 WebGL shader 在截图或 canvas 上绘制。视觉上非常灵活,但从 DOM 栅格化出来的东西就是一张静态图,除非你重新截取。

想看这些包底下包的是什么,我们的 CSS 和 SVG Liquid Glass 教程用纯代码演示了前两种。

各个 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 模糊之上用 filter: url() 套一个 SVG feDisplacementMap 滤镜,做三次位移来模拟色差,在 Firefox 里则完全跳过 SVG 滤镜。README 里写着 Safari 和 Firefox「只部分支持这个效果(看不到位移)」(only partially support the effect (displacement will not be visible))。
  • props 包括 displacementScale、blurAmount、saturation、aberrationIntensity、elasticity 和 cornerRadius,还有 mode("standard"、"polar"、"prominent" 或 "shader")。README 说 shader 模式「最准确,但不是最稳定的」(the most accurate but not the most stable)。
  • 版本 1.1.1,MIT 许可证,peer dependency 要求 React 19 或更新。Bundlephobia 测得 gzip 后约 33 KB。
  • 最近一次提交和发布都在 2025 年 6 月。目前有 25 个未关闭的 issue 和 pull request,其中 issue #20 提到:组件总会加上 translate(-50%, -50%) 居中,导致它很难放进普通布局里。

它适合 Chromium 用户为主的受众,或者落地页、demo 这类以跟随鼠标的弹性效果为卖点的场景。如果是必须在 iPhone 上也显示正常的生产环境 UI,看下一个包。

@nkzw/liquid-glass 是它的一个 fork,「修了样式问题和 TypeScript 包的问题,并做了一些简化」(with styling fixes, TypeScript package fixes, and some simplifications)。它支持 React 18 或更新。它的最近一次发布(1.3.0)也在 2025 年 6 月,渲染思路和浏览器方面的说明都一样。

@samasante/liquid-glass

Sam Asante 的这个包在我们的资源页上叫 Real liquid glass for the web。它是一个 headless 的 <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 里不做超采样,只在形状变化时重新生成贴图,每次更新都换一个新的滤镜 ID,因为 WebKit 按 ID 缓存滤镜输出。
  • 版本 0.1.1,发布于 2026 年 6 月 23 日,MIT 许可证,零运行时依赖,peer 要求 React 18 或更新。Bundlephobia 测得 gzip 后约 17 KB。最近 30 天下载量约 63,000,GitHub 上约 670 颗星。
  • 仓库自 2026 年 6 月 23 日之后就没有新提交,那时距仓库创建大约才一个小时。所以依赖它之前,锁定版本号,并读一遍源码。

Liqui 组件库(我们自己的项目)

Liqui 是我们自己的开源项目,看这一条时请把这点考虑进去。它是一套基于 Base UI 的组件,共 38 个(按钮、菜单、选择框、对话框、滑块、iOS 风格的标签栏,以及配套的表单控件),由 shadcn CLI 以源码形式写进你的仓库。唯一的 npm 依赖是折射内核 @liqui-design/glass。

  • 它在 Chromium 里用第 1 种技术,在 Safari 和 Firefox 里用第 2 种:用 LiquiBackdrop 包住一块区域,页面本身无法折射时,里面的每个玻璃表面都会改为弯折这个背景的一份副本。没有已知背景的表面,或者 portal 到盒子外面的弹出层,会退回到磨砂,边缘高光保留。
  • 位移贴图在 canvas 上只画一次,按尺寸和光学参数缓存;所有滤镜放在同一个共享的 SVG 注册表里,所以很多个相同的按钮只需要一张贴图。
  • @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 月。放在静态背景上做 hero 视觉没问题,用在会变化的内容上方做 UI 就不太合适。

Charles Yin 的 Liquid Glass Studio 是一个 playground,算不上组件库:基于 WebGL2 和 WebGPU,MIT 许可证,控制项很细。仓库在 2026 年 9 月还有更新。想看 shader 能把这种外观推到什么程度,这里很合适;如果你的玻璃本来就浮在自己渲染的 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。放在 LiquiBackdrop 里时,它在 Safari 和 Firefox 中也能折射,放在外面就是磨砂效果。
  3. 如果你的受众主要是桌面版 Chrome,又想要一个拿来就用、带鼠标弹性的组件,liquid-glass-react 可以。确保平面模糊的回退效果本身看起来是完成品,并为定位上的怪癖留出时间。
  4. 如果你只需要几个按钮或一条导航栏,就别引入依赖了。我们教程里的滤镜和贴图生成器只有几十行,回退方案也由你自己掌控。
  5. 如果玻璃下面是 canvas、3D 场景或视频,用 shader;视频的话也可以用 @samasante/liquid-glass 的 WebGL 模式。
  6. 如果你真正想要的是合并和形变,用 liquid-gooey,玻璃本身保持简单。

Sanoj Sunny 的 音量滑块概念设计 很适合拿来测试这些库。一条透明的玻璃轨道压在照片上,音量值(52)是轨道里的第二个胶囊,旁边浮着一个圆形按钮。在 Safari 里复刻它,就得折射照片的一份副本:@samasante/liquid-glass 可以用 refract prop 做到,liquid-glass-react 做不到。

透明玻璃音量滑块停在 52,旁边浮着一个圆形 AirPlay 样式按钮,背景是手握音箱的暗色照片
Liquid Glass - Slider Concept(Volume) by sanoj sunny。 在图库中查看

Roman Vasylovskyi 的 Liquid glass navigation 属于第 1 条里那种更难办的情况:网站页头浮在一张满幅沙丘照片上,山脊线在导航栏里明显弯折。如果下面是固定的 hero 图,可以把同一张照片交给 @samasante/liquid-glass。一旦页面在页头下面滚动,不管用哪个库,都只有 Chromium 能显示出弯折。

玻璃导航栏里有链接和 Get Started 按钮,背后是深色沙丘,山脊线经过导航栏时被弯折
Liquid glass navigation by Roman Vasylovskyi。 在图库中查看

不管选哪个,网页性能与回退指南都讲了 prefers-reduced-transparency 下的不透明回退,以及一个页面能承受多少层玻璃。

Vue 里的 Liquid Glass

我们资源页上的 Liquid Glass Vue 项目是一个 Vue 3 加 Vite 的 demo,用 WebGL 渲染折射。它是个拿来学习的项目,没法当成包直接安装。GitHub 也没有在仓库里检测到许可证文件,所以把代码复制进商业产品之前,先问问作者。如果要组件,npm 上的 liqvued(MIT 许可证,版本 0.2.1,发布于 2026 年 7 月,要求 Vue 3.5 或更新)在 Chromium 里用 backdrop-filter: url(),按它文档的说法,在 Safari 和 Firefox 里会退回到模糊效果。

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

参考来源

更新于

分享这篇文章

每周更新,精选新参考

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

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