---
title: "Liquid Glass React 函式庫比較（2026）"
description: "Liquid Glass React 函式庫比較：liquid-glass-react、@samasante/liquid-glass 與 WebGL 方案的算繪方式、折射支援和選法。"
url: https://liquidglassdesign.com/zh-TW/blog/liquid-glass-react-libraries
language: zh-Hant
published: 2026-11-18
updated: 2026-11-20
author: "Liquid Glass Design"
tags: ["Web 前端","程式碼"]
translations:
  en: https://liquidglassdesign.com/blog/liquid-glass-react-libraries.md
  zh-Hans: https://liquidglassdesign.com/zh/blog/liquid-glass-react-libraries.md
  ja: https://liquidglassdesign.com/ja/blog/liquid-glass-react-libraries.md
  hi: https://liquidglassdesign.com/hi/blog/liquid-glass-react-libraries.md
---

# Liquid Glass React 函式庫比較（2026）

> Liquid Glass React 函式庫比較：liquid-glass-react、@samasante/liquid-glass 與 WebGL 方案的算繪方式、折射支援和選法。

在 React 裡做 Liquid Glass（液態玻璃），主要是在兩個套件之間選：`liquid-glass-react` 是下載量最高的玻璃元件，但只在 Chromium 裡彎折背景；`@samasante/liquid-glass` 是比較新的 headless 透鏡元件，只要把要彎折的內容交給它，在 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 位移濾鏡。它從不讀取背景，所以三大引擎都能用。麻煩的是，元件手上得有一份要彎折的東西的副本。
3. 在截圖或 canvas 上繪製的 WebGL 著色器。視覺上非常靈活，但從 DOM 點陣化出來的東西，在你重新擷取之前都只是一張靜態圖片。

如果想知道這些套件包裝了什麼，我們的 [CSS 與 SVG Liquid Glass 教學](https://liquidglassdesign.com/zh-TW/blog/liquid-glass-css-svg)用純程式碼示範了前兩種。

## Liquid Glass React 函式庫

### liquid-glass-react

Max Rovensky 的 [Liquid Glass React](https://liquidglassdesign.com/resources/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「只部分支援這個效果（看不到位移）」。
- 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。
- 最後一次 commit 和發布都在 2025 年 6 月。目前有 25 個未關閉的 issue 和 pull request，其中 issue #20 提到：元件一律用 `translate(-50%, -50%)` 置中，很難放進一般的版面配置裡。

它適合 Chromium 使用者占多數的受眾，或是以跟著滑鼠的彈性效果為賣點的到達頁和 demo。如果是要在 iPhone 上也正確呈現的正式產品 UI，請看下一個套件。

`@nkzw/liquid-glass` 是它的 fork，「修正了樣式和 TypeScript 套件的問題，並做了一些簡化」。它接受 React 18 以上。最後一次發布（1.3.0）同樣在 2025 年 6 月，算繪方式和瀏覽器說明也都一樣。

### @samasante/liquid-glass

Sam Asante 的這個套件收錄在我們的資源頁，名稱是 [Real liquid glass for the web](https://liquidglassdesign.com/resources/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 dependency 是 React 18 以上。Bundlephobia 測得 gzip 後約 17 KB。最近 30 天下載量約 63,000 次，GitHub 上約 670 顆星。
- 這個 repo 從 2026 年 6 月 23 日起就沒有新的 commit，而那時距離它建立才大約一小時，所以要依賴它之前，先鎖定版本並讀過原始碼。

### Liqui，一套元件函式庫（我們做的）

[Liqui](https://liqui.design/?utm_source=liquidglassdesign.com&utm_medium=referral&utm_campaign=blog_react_libraries) 是我們自己的開源專案，看這一項時請把這點考慮進去。它是一套 38 個 Base UI 元件（按鈕、選單、下拉選單、對話框、滑桿、iOS 風格的標籤頁列，以及搭配它們的表單控制項），由 shadcn CLI 以原始碼的形式寫進你的 repo。唯一的 npm 相依套件是折射核心 `@liqui-design/glass`。

- 它在 Chromium 用做法 1，在 Safari 和 Firefox 用做法 2：用 `LiquiBackdrop` 包住一塊區域，在頁面本身無法折射的地方，裡面的每個玻璃表面都會彎折那塊背景的副本。沒有已知背景的表面，或是被 portal 到區塊外的彈出式面板，會改成霧面，並保留邊緣光。
- 位移貼圖只在 canvas 上繪製一次，並依尺寸和光學參數快取；所有濾鏡都放在同一個共用的 SVG 登錄表裡，所以許多一模一樣的按鈕只需要一張貼圖。
- `@liqui-design/glass` 版本 0.8.0，2026 年 11 月 17 日發布，MIT 授權，peer dependency 是 React 18 或 19，元件需要 Tailwind CSS v4。到 11 月 18 日為止的 30 天內，npm 下載量約 5,000 次，GitHub 上約 170 顆星（2026 年 11 月 20 日核對）。
- 安裝設定、標籤頁列和 Safari 的細節，都在我們的 [Liquid Glass React 元件指南](https://liquidglassdesign.com/zh-TW/blog/liquid-glass-react-components)裡。

### 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](https://liquidglassdesign.com/resources/liquid-glass-studio) 是採用 MIT 授權的 playground，並非元件函式庫，建構在 WebGL2 和 WebGPU 上，控制選項很細。repo 在 2026 年 9 月有更新。想看看著色器能把這種外觀推到什麼程度，這裡很適合；如果你的玻璃疊在你本來就在算繪的 canvas 場景上，也可以借用它的數學。

### liquid-gooey：負責變形的部分

Jakub Antalik 的 [Liquid Gooey](https://liquidglassdesign.com/resources/liquid-gooey) 負責這種外觀裡的變形，透鏡不歸它管：形狀像液體一樣合併、分開，有「Morph」和「Move」兩種效果。它把黏稠的液體畫在一層 SVG 剪影上，真正的 DOM 則清晰地留在上方；README 說它只對 SVG 內容套用濾鏡，從不在 HTML 上使用 CSS `url()`，所以在 Safari 裡也能正確顯示。版本 0.2.2，2026 年 9 月發布，MIT 授權，peer dependency 是 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 的[音量滑桿概念設計](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29)很適合拿來測試這些函式庫。透明的玻璃軌道疊在照片上，音量（52）是軌道裡的第二個膠囊，旁邊還浮著一個圓形按鈕。要在 Safari 裡重現，就得折射照片的副本：`@samasante/liquid-glass` 可以透過 `refract` prop 做到，`liquid-glass-react` 則做不到。

![停在 52 的透明玻璃音量滑桿，和一個 AirPlay 風格的圓形按鈕，浮在一張手拿喇叭的深色照片上](https://cdn.liquidglassdesign.com/gallery/296cd13d-8a84-8095-9a94-c13755eef388.webp)

*Liquid Glass - Slider Concept(Volume) by sanoj sunny。* [在作品集中查看](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29)
Roman Vasylovskyi 的 [Liquid glass navigation](https://liquidglassdesign.com/gallery/liquid-glass-navigation) 是規則 1 裡比較難的情況：網站頁首浮在一張滿版的沙丘照片上，稜線在頁首裡明顯彎折。如果背後是固定的主視覺圖片，可以把同一張照片傳給 `@samasante/liquid-glass`。一旦頁面在頁首底下捲動，不管用哪個函式庫，都只有 Chromium 會顯示彎折。

![玻璃導覽列上有幾個連結和一個 Get Started 按鈕，後方深色沙丘的稜線在導覽列背後彎折](https://cdn.liquidglassdesign.com/gallery/22acd13d-8a84-80ef-8228-f1b3eeb5f2e1.webp)

*Liquid glass navigation by Roman Vasylovskyi。* [在作品集中查看](https://liquidglassdesign.com/gallery/liquid-glass-navigation)
不管選哪一個，[網頁效能與備援指南](https://liquidglassdesign.com/zh-TW/blog/liquid-glass-web-performance-fallbacks)都談到了針對 `prefers-reduced-transparency` 的實心備援，以及一個頁面撐得起幾層玻璃。

## Vue 版的 Liquid Glass

我們資源頁上的 [Liquid Glass Vue](https://liquidglassdesign.com/resources/liquid-glass-vue) 是一個用 Vue 3 和 Vite 做的示範專案，以 WebGL 算繪折射。它適合拿來學習，並非可以直接安裝的套件，而且 GitHub 在 repo 裡偵測不到授權檔案，所以把程式碼複製進商業產品之前，先問過作者。如果要元件，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
