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 裡彎折背景;@samasante/liquid-glass 是比較新的 headless 透鏡元件,只要把要彎折的內容交給它,在 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 位移濾鏡。它從不讀取背景,所以三大引擎都能用。麻煩的是,元件手上得有一份要彎折的東西的副本。 - 在截圖或 canvas 上繪製的 WebGL 著色器。視覺上非常靈活,但從 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「只部分支援這個效果(看不到位移)」。 - 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。它是 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 是我們自己的開源專案,看這一項時請把這點考慮進去。它是一套 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 元件指南裡。
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 是採用 MIT 授權的 playground,並非元件函式庫,建構在 WebGL2 和 WebGPU 上,控制選項很細。repo 在 2026 年 9 月有更新。想看看著色器能把這種外觀推到什麼程度,這裡很適合;如果你的玻璃疊在你本來就在算繪的 canvas 場景上,也可以借用它的數學。
liquid-gooey:負責變形的部分
Jakub Antalik 的 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 次。想讓選單從按鈕裡冒出來時,可以把它和以模糊為基礎的玻璃表面搭配使用。
選擇原則
- 如果 iPhone 和 Safari 使用者一定要看到折射,就用
@samasante/liquid-glass,折射元素自己的子元素,或是你傳進去的副本。也要接受一件事:在 Chromium 以外,浮在任意即時內容上的面板只會有霧面,不會彎折。 - 如果你想在 shadcn/ui 和 Tailwind v4 上用一整套玻璃元件(選單、下拉選單、對話框、標籤頁列),就用我們做的 Liqui。在 Safari 和 Firefox 裡,它會在
LiquiBackdrop內折射,其他地方則是霧面。 - 如果你的使用者大多用桌面版 Chrome,又想要一個裝上就能用、帶滑鼠彈性效果的元件,
liquid-glass-react可以勝任。記得確認單純模糊的備援看起來像完成品,並預留時間處理定位上的怪問題。 - 如果只需要幾個按鈕或一條導覽列,就別加這個相依套件。我們教學裡的濾鏡和貼圖產生器只有幾十行,備援方式也由你自己掌控。
- 如果玻璃底下是 canvas、3D 場景或影片,就用著色器;影片的話,也可以用
@samasante/liquid-glass的 WebGL 模式。 - 如果你真正想要的是合併和變形,就用
liquid-gooey,玻璃本身則保持簡單。
Sanoj Sunny 的音量滑桿概念設計很適合拿來測試這些函式庫。透明的玻璃軌道疊在照片上,音量(52)是軌道裡的第二個膠囊,旁邊還浮著一個圓形按鈕。要在 Safari 裡重現,就得折射照片的副本:@samasante/liquid-glass 可以透過 refract prop 做到,liquid-glass-react 則做不到。

Roman Vasylovskyi 的 Liquid glass navigation 是規則 1 裡比較難的情況:網站頁首浮在一張滿版的沙丘照片上,稜線在頁首裡明顯彎折。如果背後是固定的主視覺圖片,可以把同一張照片傳給 @samasante/liquid-glass。一旦頁面在頁首底下捲動,不管用哪個函式庫,都只有 Chromium 會顯示彎折。

不管選哪一個,網頁效能與備援指南都談到了針對 prefers-reduced-transparency 的實心備援,以及一個頁面撐得起幾層玻璃。
Vue 版的 Liquid Glass
我們資源頁上的 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
更新於