Communitygithub.com

kubai-liquid-glass

為圖片、壁紙或影片上方的卡片和面板添加液態玻璃材質:背景模糊與提亮、邊緣折射與色散、根據背景自動調整的著色和文字顏色,深色和淺色模式下文字都清晰可讀,佈局保持不變(liquid glass, glassmorphism)。

kubai-liquid-glass 是什麼?

這是一個為 UI 表面(如卡片、面板、搜尋列)添加「液態玻璃」材質的 AI 技能,專注於提升視覺質感而非改變佈局。它透過 CSS 變數、backdrop-filter、box-shadow 和 SVG 位移貼圖,模擬出具有邊緣折射、色散與背景自適應色調的厚玻璃效果。技能支援淺色/深色主題,能根據背景取樣自動調整玻璃密度、墨水顏色及色澤飽和度,並遵循無障礙設計與使用者偏好。主要實現在 Chromium 瀏覽器上完整運作,Firefox 等則回退到純 CSS 玻璃效果。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-liquid-glass

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

液態玻璃材質

《999 個小技巧,讓你 Vibe 的產品更有質感》第 010 期 · @kubai087

在用戶的專案裡按下面的要求改造。要求以用戶的口吻寫成:文中的 I、me、my 指用戶;寫著要先問的地方,先停下來問用戶再繼續。

改造要求

為我產品中的卡片和面板賦予液態玻璃材質:一種能從背景取色、邊緣呈現厚玻璃感、能適應背景內容,並在淺色和深色模式下保持文字可讀的清澈玻璃。請在我現有的設計系統內運作。這僅是表面材質的改變,而非佈局變動:保留我的標記、間距、圓角、字型、圖示和文案。

  1. 從現有內容開始
  • 找出所有位於圖片、壁紙、影片或複雜背景之上的表面:卡片、播放器、搜尋列、工具列、選單、彈出視窗、提示框。列出其元件名稱與所在位置。
  • 找出產品如何在淺色和深色模式之間切換,以及色彩 token 存放在何處。玻璃材質應寫入這些 token 中,而非逐一修改元件。
  • 跳過位於純色背景之上的表面;放在純色上的玻璃只會看起來灰濛濛的。
  1. 材質 token 每種狀態建立一組變數,表面只需套用即可。下列數值為起始值,適用於一般大小的介面。
  • 淺色玻璃、深色文字(預設):白色透明度 6–22%(依密度,步進 4);backdrop filter blur(2px) saturate(180%) brightness(1.06),讓顏色從背景而來,保持鮮豔而非混濁。 邊框:inset 1.5px 1.5px 1px -1px 白色 95%, inset -1.5px -1.5px 1px -1px 白色 55%, inset 0 0 0 0.5px 白色 30%, 0 0 0 0.5px 黑色 6%, 0 6px 24px 黑色 8%。 內部光暈(在表面內部的圖層上):從左上角放射狀高光(白色 30% 漸淡至 55%),以及邊緣內側的柔和內光暈,頂部和左側較亮,底部略暗。
  • 淺色模式下於深色區域上的玻璃、淺色文字:rgb(16 18 22) 透明度 10–30%;filter blur(2px) saturate(170%) 後 brightness(0.85);邊框:頂部一條微弱的白色內線,以及 0.5px 的深色外框。
  • 深色模式:rgb(20 20 24) 透明度 16–38%;filter blur(2px) saturate(160%) brightness(0.8),這會使顏色變暗,類似色彩增值效果,但不會變得混濁;相同的邊框和內部光暈,強度約為三分之一,並搭配更暗的外框和陰影。
  • 墨水色:一種固定的漸層顏色,用於繪製玻璃上的所有內容: 淺色玻璃上:黑色 86%(用於標題、圖示、時間、進度條)、rgb(60 60 67) 透明度 70%(次要);mix-blend-mode: multiply; 深色玻璃上:白色 94%、rgb(235 235 245) 透明度 64%;mix-blend-mode: plus-lighter。 圖示應以不透明顏色繪製,再透過 opacity 淡出整個圖示:半透明顏色會在形狀的筆畫和填色重疊處變暗。
  • 淺色玻璃上的高亮行,應是玻璃的更亮圖層:懸停時白色 42%,選中時 76%,並帶有白色描邊。絕不使用灰色覆蓋層。
  • 使用 @property 註冊數值和顏色 token,讓表面狀態切換時能夠平滑過渡,而非跳躍。
  1. 用四個宣告來套用 每個表面只需修改以下四項,標記保持不變:
  • background:色調。
  • backdrop-filter:材質的濾鏡,然後是邊緣透鏡(第 3 步)放在最後,讓色彩疊合在一次過濾中完成,且彎曲保持清晰。
  • box-shadow:邊框。
  • color:墨水色,並對內部所有內容套用混合模式。 懸停時,將色調亮度提升約 14%,而非抬高陰影。
  1. 邊緣透鏡
  • 為每個表面建立位移貼圖:紅色通道代表水平彎曲,綠色通道代表垂直彎曲,128 表示無彎曲。只有邊緣彎曲,中間保持平坦。
  • 邊緣寬度約為卡片上的 44px(min(44px, 短邊 / 3.5),永遠不小於 4px)。對於厚玻璃,距離邊緣 d 的點向內彎曲量為 1.1 × rim × (1 - d / rim)^2.6:邊緣處最強,場景在此摺疊回自身,向邊緣內側逐漸減弱至零。
  • 貼圖形狀需與 CSS 繪製的圓角一致。若表面使用 corner-shape: superellipse(),則應跟隨超級橢圓曲線,而非圓弧,否則彎曲與邊緣光暈會在角落處錯開。
  • 將貼圖放入 SVG 濾鏡中,使用 feImage(貼圖)和 feDisplacementMap(縮放 = 最大偏移量的 2 倍),並在 backdrop-filter 末尾加入 url(#id)。
  • 分色處理:三次傳遞,紅色偏移再多 15%,藍色偏移再少 15%,每個通道透過 feColorMatrix 保留,並以螢幕混合疊加。在複雜背景上的寬邊緣角落處檢查效果;若分裂變成模糊光暈則降低偏移量。
  • 只有 Chromium 支援 backdrop-filter 中的 url()。請檢查 CSS.supports('backdrop-filter', 'url(#a)'),並跳過 Firefox(它會解析但不繪製任何內容)。其他瀏覽器則會退回到純 CSS 玻璃效果。
  • 在表面指向濾鏡之前,需等待貼圖圖片解碼完成,否則表面會失去模糊效果。為每個濾鏡指定唯一的 id 和專屬的 。每個半徑和邊緣寬度組合只需建立一次貼圖並重複使用;調整大小時移動貼圖,而非重建。
  • 跳過小於 32px 的表面,以及設有 will-change 或自己合成圖層的表面(選單、動畫面板),因為在這些情況下 Chrome 可能畫出貼圖而非彎曲的背景。
  1. 適應後方背景
  • 對於每個表面,在其下方取樣一個 5 × 3 的網格,移除最暗的兩個和最亮的兩個點,然後取平均。亮度計算: (0.299 R + 0.587 G + 0.114 B) / 255;紋理為最亮點減去最暗點。
  • 墨水色:淺色模式下,當亮度低於 0.5 時使用淺色文字。保持當前墨水色在 ±0.05 的範圍內,以免表面閃爍。深色模式一律使用淺色文字。同一行中的相鄰表面共用一個決定。
  • 密度(0 薄,1 濃)= 0.55 × 背景亮度與墨水色自身亮度的接近程度 + 0.7 × 紋理 + 0.3 × 色度。這會使色調在薄與濃的透明度之間移動。
  • 保留的飽和度 = 1 - 0.75 × 色度,至少 0.45,以免鮮豔的背景弄髒玻璃。
  • 當背景、主題或表面位置改變時重新取樣,並記住上一次的墨水色,以便下次載入時直接使用。
  • 如果背景不是可讀取的圖片(即時影片、跨來源內容),則從主題中選取墨水色,並使用濃色調。
  1. 讓使用者調整色調
  • 為淺色模式和深色模式各增加一個設定,用以縮放色調,範圍為 0 到 1.5(1 為設計時的材質)。低於 1 時,濾鏡中的亮度提升也隨之變薄,因此當值為 0 時,只剩下模糊、邊框和陰影。
  • 每個主題保留自己的設定值;切換主題時會平滑過渡到該主題的值。
  1. 保持無障礙
  • 在產品允許最忙碌和最暗的背景上,以預設色調檢查文字對比度;提高密度而非墨水透明度,直到對比度達標。
  • 尊重 prefers-reduced-transparency 和 forced colors 設定:退回使用相同色調、全不透明的實心表面。
  • 保留焦點外框、禁用狀態和錯誤顏色;失敗狀態維持紅色。
  1. 交付
  • 首先列出你將更改的表面,哪些表面會套用透鏡和分色效果,哪些保持實心並說明原因。
  • 然後加入 token、透鏡輔助工具和兩個設定,將表面切換到新材質,並列出你觸碰過的每個檔案。
  • 不要更改佈局、字型、圓角或文案。如果某個表面需要新增元件才能實現玻璃效果,請先停下來問我。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

相關技能