Liquid Glass Design开发阅读约 8 分钟
Liquid Glass React 库横向对比(2026)
Liquid Glass React 库对比:liquid-glass-react、@samasante/liquid-glass 和 WebGL 方案的渲染方式、浏览器支持和选法。

本文目录
在 React 里做 Liquid Glass,主要是二选一。一个是下载量最大的玻璃组件 liquid-glass-react,它只在 Chromium 里扭曲背景;另一个是较新的 headless 透镜 @samasante/liquid-glass,只要你把要扭曲的内容交给它,它在 Chrome、Safari 和 Firefox 里都能折射。其余几个分别是第一个库的 fork、基于截图工作的 WebGL 渲染器,以及一个做液态形变的库,后者根本算不上玻璃。
下面所有数字都取自 2026 年 11 月 14 日的 npm、GitHub 和 Bundlephobia。「下载量」指截至当天前 30 天的 npm 下载量。
这些库怎么做出玻璃
一共三种技术,浏览器支持上的差别几乎都能用它们解释。
- 用 SVG 位移滤镜读取元素后面的页面(
backdrop-filter: url(),或者在backdrop-filter模糊上面再叠一个filter: url())。这种方式扭曲的是实时内容,但只有 Chromium 画得出来。Safari 和 Firefox 会退回到普通的平面模糊。 - 用
filter: url()把 SVG 位移滤镜作用到组件自己持有的内容上。它从不读取 backdrop,所以三个引擎都能用。问题在于,组件手里必须有一份它要扭曲的内容的副本。 - 用 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()套一个 SVGfeDisplacementMap滤镜,做三次位移来模拟色差,在 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/glass0.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。想让菜单从按钮里「冒」出来,就把它和一层基于模糊的玻璃表面搭配使用。
怎么选
- 如果 iPhone 和 Safari 用户必须看到折射,用
@samasante/liquid-glass,让它折射元素自己的子元素,或者你传进去的副本。同时接受一点:在 Chromium 以外,浮在任意实时内容上的面板只会有磨砂效果,扭不出折射。 - 如果你想在 shadcn/ui 和 Tailwind v4 上用一整套玻璃组件(菜单、选择框、对话框、标签栏),用我们的库 Liqui。放在
LiquiBackdrop里时,它在 Safari 和 Firefox 中也能折射,放在外面就是磨砂效果。 - 如果你的受众主要是桌面版 Chrome,又想要一个拿来就用、带鼠标弹性的组件,
liquid-glass-react可以。确保平面模糊的回退效果本身看起来是完成品,并为定位上的怪癖留出时间。 - 如果你只需要几个按钮或一条导航栏,就别引入依赖了。我们教程里的滤镜和贴图生成器只有几十行,回退方案也由你自己掌控。
- 如果玻璃下面是 canvas、3D 场景或视频,用 shader;视频的话也可以用
@samasante/liquid-glass的 WebGL 模式。 - 如果你真正想要的是合并和形变,用
liquid-gooey,玻璃本身保持简单。
Sanoj Sunny 的 音量滑块概念设计 很适合拿来测试这些库。一条透明的玻璃轨道压在照片上,音量值(52)是轨道里的第二个胶囊,旁边浮着一个圆形按钮。在 Safari 里复刻它,就得折射照片的一份副本:@samasante/liquid-glass 可以用 refract prop 做到,liquid-glass-react 做不到。

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

不管选哪个,网页性能与回退指南都讲了 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 日。
参考来源
- https://github.com/rdev/liquid-glass-react
- https://github.com/rdev/liquid-glass-react/blob/master/src/index.tsx
- https://github.com/rdev/liquid-glass-react/issues/20
- https://www.npmjs.com/package/liquid-glass-react
- https://github.com/nkzw-tech/liquid-glass
- https://github.com/samasante/liquid-glass
- https://liqui.design/docs/handbook/glass
- https://www.npmjs.com/package/@liqui-design/glass
- https://github.com/leefanv/liqui-design
- https://github.com/samasante/liquid-glass/blob/main/BROWSERS.md
- https://www.npmjs.com/package/@samasante/liquid-glass
- https://github.com/Specy/liquid-glass
- https://www.npmjs.com/package/@specy/liquid-glass-react
- https://github.com/iyinchao/liquid-glass-studio
- https://github.com/Jakubantalik/Libraries
- https://www.npmjs.com/package/liquid-gooey
- https://github.com/Muggleee/liquid-glass
- https://www.npmjs.com/package/liqvued
- https://ivoyt.github.io/liqvued/guide/browser-compatibility
- https://bundlephobia.com/package/liquid-glass-react
- https://api.npmjs.org/downloads/point/last-month/liquid-glass-react
更新于