liquid-glass · mode="bottom-tabs"
点击或左右拖动标签可在「首页 / 发现 / 收藏」之间切换,选中指示器为液态玻璃胶囊,随手指实时折射背景。
这个标签栏不是 CSS 画的,而是一个 WebGL 组件:它把「背景壁纸 + 玻璃光学」实时渲染到 <canvas> 上。
整条栏由下面 4 层 叠加而成,下面按实现顺序给出每一部分的真实代码与中文注释。
组件是一个自定义元素;用 setTabs() 配置标签,用 setLiquid() 调玻璃光学。背景图用「直链」直接填进 wallpaper 属性。
<!-- 1) 挂载:整个标签栏就是一个自定义元素 <liquid-glass> -->
<liquid-glass
id="tabs"
dark
mode="bottom-tabs"
blur-tap-cap="9"
dpr="2"
wallpaper="https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=1600&q=80"
style="width:340px;height:200px;border-radius:26px;"
></liquid-glass>
<script>
const el = document.getElementById('tabs');
// setTabs 接收「栏」的数组:外层一个元素 = 一条标签栏。
// 只给一组时,第二条栏会用库内置默认值(Tab 1 / Tab 2 / Tab 3 / Tab 4)。
el.setTabs([[
{ icon: HOME, label: '首页', viewport: 24 }, // 图标用 SVG path,不用 emoji
{ icon: DISCOVER, label: '发现', viewport: 24 },
{ icon: FAVORITE, label: '收藏', viewport: 24 },
]]);
// setLiquid:玻璃的光学参数(与官方示例完全一致)
el.setLiquid({
enabled: 1, // 1 = 开启液态玻璃
fluidStrength: 0.9, // 流体扰动强度
refractionScale: 1.6, // 折射缩放(越大越“放大”背景)
fresnelStrength: 1.2, // 边缘菲涅尔高光强度
dispersion: 1, // 色散 → 边缘彩色分光
});
</script>
先把所有尺寸从 dp 换算成像素,再建外层容器。gooseGlass() 就是“造一块玻璃”的工厂函数,参数决定它怎么折射、模糊、投影。
// ── 来自库函数 buildBottomTabs():先算几何,再搭 4 层 ──
// 所有尺寸都以 dp 为单位,再乘以设备系数 gooseDP2 换算成像素
const TABS_PAD = 36 * gooseDP2; // 左右留白:玻璃条距组件边缘 36dp
const TABS_W = W - 2 * TABS_PAD; // 可用宽度
const CONTAINER_H = 64 * gooseDP2; // 外容器(看得见的胶囊)高度 64dp
const GLASS_H = 56 * gooseDP2; // 内层玻璃板高度 56dp
const GLASS_PAD = 4 * gooseDP2; // 内层比外容器内缩 4dp
const containerX = TABS_PAD;
const containerR = CONTAINER_H / 2; // 半径 = 高度一半 → 胶囊形状
const glassX = TABS_PAD + GLASS_PAD;
const glassR = GLASS_H / 2;
// 第 1 层:外层「容器玻璃」——负责整条栏的磨砂、折射、投影
const containerEl = gooseGlass(
`${idPrefix}-container`,
{ x: containerX, y, w: containerW, h: CONTAINER_H },
{
cornerRadius: containerR, // 32dp,胶囊
refractionHeight: 24 * gooseDP2, // 折射只发生在边缘 24dp 高度内
refractionAmount: -24 * gooseDP2, // 负值 = 向内“把背景吸进来”
blurRadius: 8 * gooseDP2, // 磨砂:8dp 高斯模糊
saturation: 1.5, // 提高饱和度,玻璃下的颜色更艳
surfaceColor: containerColor, // 表面染色(暗色模式=深色半透明)
highlight: { ...gooseHL, alpha: 1 }, // 顶部一条 0.5dp 的高光描边
outerShadow: null, // 外容器不投影
depthEffect: true, // 开启“厚度感”,边缘出现立体折射
}
);
// 告诉渲染器:这块是标签栏容器(记录组 id 和有几个标签)
containerEl.isBottomTabContainer = { groupId: idPrefix, tabsCount };
每个标签是一块 gooseText,坐标按 glassX + i × tabW 排布;图标直接喂 SVG path,所以全程不用 emoji。
// ── 第 4 层:标签内容(图标 + 文字),来自 gooseText() ──
// 每个标签占一个格子:x = glassX + i * tabW
for (let i = 0; i < tabsCount; i++) {
const cfg = tabs === undefined ? undefined : tabs[i];
const iconPath = cfg?.icon ?? gooseFlight; // 没给图标就用内置小飞机
const label = cfg?.label ?? `Tab ${i + 1}`; // 没给文字就用 Tab N
const tabEl = gooseText(
`${idPrefix}-tab-${i}`,
{ x: glassX + tabW * i, y: glassY, w: tabW, h: GLASS_H }, // 第 i 个标签的格子
label,
{
color: palette.tabsContentColor,
fontSizePx: 12,
fontWeight: 400,
align: 'center',
halo: palette.tabsTextHalo, // 文字光晕,保证在任意背景上都看得清
icon: {
path: iconPath, // ← SVG path 数据(所以不用 emoji)
size: 24, // 图标绘制尺寸 24dp
layoutSize: 28, // 图标占位尺寸 28dp
color: iconColor,
viewport: cfg?.viewport ?? 960,// SVG viewBox 大小,默认 960
},
}
);
// 每个标签的点击/拖动都交给同一套交互处理
interactions[`${idPrefix}-tab-${i}`] = {
onTap: () => onSelect(i),
onDragStart: dragInteractions.onDragStart,
onDrag: dragInteractions.onDrag,
onDragEnd: dragInteractions.onDragEnd,
};
}
指示器本身是“透明玻璃”:不染色、不模糊,只靠折射和边缘色散显形;它的位置由 isBottomTabIndicator.dragWidth 与当前分数决定。
// ── 第 3 层:选中「滑动指示器」——一块 56dp 高的透明玻璃胶囊 ──
const indicatorEl = gooseGlass(
`${idPrefix}-indicator`,
// x 先放在最左侧;真实位置 = glassX + 分数 * tabW(分数由交互层驱动)
{ x: TABS_PAD + GLASS_PAD, y: glassY, w: tabW, h: GLASS_H },
{
cornerRadius: glassR, // 28dp,胶囊
refractionHeight: 10 * gooseDP2,
refractionAmount: -14 * gooseDP2, // 比容器更弱的折射
blurRadius: 0, // 指示器本身不模糊(只有按下时像“镜片”)
saturation: 1,
tintColor: [0, 0, 0, 0], // 透明:不染色
surfaceColor: [0, 0, 0, 0], // 透明:没有表面色
highlight: { ...gooseHL, alpha: 1 }, // 高光强度按下时由进度控制
// 外投影:半径 24dp、向下偏移 4dp、黑色 10% 透明度
outerShadow: { radius: 24 * gooseDP2, alpha: 0.1, offsetX: 0, offsetY: (24 / 6) * gooseDP2, color: [0, 0, 0] },
// 内投影:半径 8dp、向下偏移 8dp、黑色 15%
innerShadow: { radius: 8 * gooseDP2, alpha: 0.15, offsetX: 0, offsetY: 8 * gooseDP2 },
chromaticAberration: true, // 边缘色散 → 出现彩色描边
}
);
// 渲染器据此把指示器“放”到当前分数对应位置,并按需缩放
indicatorEl.isBottomTabIndicator = {
groupId: idPrefix,
dragWidth: tabW, // 位置 = selectedFraction * tabW
pressedScale: 78 / 56, // 按下时放大到 78/56(宽高同比例)
};
点击把“目标分数”设为下标;拖动时分数 = 起点 + 位移÷标签宽;松手四舍五入就近吸附。全部用弹簧动画过渡,所以是“弹”过去的。
// ── 交互:点击 / 拖动,全部由 DampedDragAnimation 的弹簧动画驱动 ──
// 点击某个标签:把“目标分数”设为该下标,剩下的交给动画弹过去
gooseTabSel(groupId, tabIndex, tabsCount) {
const st = this.gooseEnsureTgl(groupId, tabIndex, LiquidGlassRenderer.gooseTabScale, tabsCount - 1);
if (st.isDragging) return; // 拖动中忽略点击
st.targetFraction = tabIndex; // 目标位置(浮点,允许中间态)
st.trackVelocityAfterRelease = false;
st.targetVelocity = 0; st.velocity = 0; st.velocityVelocity = 0;
st.velocityTracker.resetTracking();
if (st.targetPress === 0) { // 播放“按下”动画:56dp → 78dp
st.targetPress = 1;
st.targetScaleX = st.pressedScale;
st.targetScaleY = st.pressedScale;
}
this.gooseAnimStart(); // 启动逐帧动画
},
// 拖动:目标位置 = 起点下标 + 水平位移 / 单个标签宽度
gooseTabDrag(groupId, startTabIndex, currentX, startX, tabWidth, tabsCount) {
const st = this.gooseEnsureTgl(groupId, startTabIndex, LiquidGlassRenderer.gooseTabScale, tabsCount - 1);
if (!st.isDragging) return;
const delta = (currentX - startX) / Math.max(1, tabWidth);
st.targetFraction = Math.max(0, Math.min(tabsCount - 1, startTabIndex + delta)); // 限制在 0..N-1
// 整条栏还会跟着手指横移最多 4dp(先快后慢),制造轻微整体位移
const offsetFraction = Math.max(-1, Math.min(1, (currentX - startX) / Math.max(1, tabWidth * tabsCount)));
const easeOut = 1 - Math.pow(1 - Math.abs(offsetFraction), 2);
st.targetPanelOffset = 4 * gooseDP * Math.sign(offsetFraction) * easeOut;
this.gooseAnimStart();
},
// 松手:就近吸附到最近的标签,横移弹回 0,返回最终下标
gooseTabDragEnd(groupId, tabsCount) {
const st = this.toggleStates.get(groupId);
if (!st) return 0;
st.isDragging = false;
const clamped = Math.max(0, Math.min(tabsCount - 1, Math.round(st.targetFraction))); // 四舍五入
st.targetFraction = clamped;
st.targetPanelOffset = 0;
this.gooseAnimStart();
return clamped; // 交给 onSelect 更新选中状态
}
玻璃里看到的背景,是着色器按 cover 裁剪采样壁纸,再做 9 抽样高斯模糊得到的;最后用胶囊形 SDF 决定哪些像素画出来。
// ── 折射与高光:指示器的背景由这段 GLSL 着色器算出来 ──
// 指示器 = 壁纸(外层) + 容器玻璃(内层),用 9 次采样做模糊
vec4 sampleIndicatorBackdrop(vec2 canvasPx, float radius) {
// 1) 采样壁纸:coverUv 做“cover 裁剪”,保证铺满不变形
vec2 uv = coverUv(canvasPx);
// 半径太小 → 直接取原图,不做模糊
if (radius < 0.5) {
return texture2D(uWallpaperSampler, uv);
}
// 2) 9 抽样高斯模糊:
// 中心 0.25,上下左右各 0.12,四个对角各 0.0675(权重加起来 = 1)
vec2 pxToUv = radius * canvasPxToUvScale();
vec4 sum = texture2D(uWallpaperSampler, uv) * 0.25;
sum += texture2D(uWallpaperSampler, uv + vec2( 1.000, 0.000) * pxToUv) * 0.12;
sum += texture2D(uWallpaperSampler, uv + vec2(-1.000, 0.000) * pxToUv) * 0.12;
sum += texture2D(uWallpaperSampler, uv + vec2( 0.000, 1.000) * pxToUv) * 0.12;
sum += texture2D(uWallpaperSampler, uv + vec2( 0.000, -1.000) * pxToUv) * 0.12;
sum += texture2D(uWallpaperSampler, uv + vec2( 0.707, 0.707) * pxToUv) * 0.0675;
sum += texture2D(uWallpaperSampler, uv + vec2( 0.707, -0.707) * pxToUv) * 0.0675;
sum += texture2D(uWallpaperSampler, uv + vec2(-0.707, 0.707) * pxToUv) * 0.0675;
sum += texture2D(uWallpaperSampler, uv + vec2(-0.707, -0.707) * pxToUv) * 0.0675;
// 3) 返回模糊后的颜色;再用胶囊形 SDF 决定哪些像素真正被画出来
return sum;
}