完整标签栏

liquid-glass · mode="bottom-tabs"

完整标签栏 bottom-tabs

点击或左右拖动标签可在「首页 / 发现 / 收藏」之间切换,选中指示器为液态玻璃胶囊,随手指实时折射背景。

实现拆解 · 带注释的代码

这个标签栏不是 CSS 画的,而是一个 WebGL 组件:它把「背景壁纸 + 玻璃光学」实时渲染到 <canvas> 上。 整条栏由下面 4 层 叠加而成,下面按实现顺序给出每一部分的真实代码与中文注释。

① 内层背景板(隐藏的 56dp 玻璃,被指示器采样,官方用蓝色滤镜染色)
② 容器玻璃:外层看得见的 64dp 胶囊,负责磨砂 + 折射 + 立体感
③ 滑动指示器:选中的 56dp 透明玻璃胶囊,位置 = 分数 × 单个标签宽
④ 标签内容:每个格子里的 图标(SVG path) + 文字

1. 怎么用:挂载 + 配置

HTML / JS

组件是一个自定义元素;用 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>

2. 几何 + 容器玻璃

buildBottomTabs()

先把所有尺寸从 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 };

3. 标签内容:图标 + 文字

gooseText()

每个标签是一块 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,
  };
}

4. 滑动指示器(透明玻璃胶囊)

indicator

指示器本身是“透明玻璃”:不染色、不模糊,只靠折射和边缘色散显形;它的位置由 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(宽高同比例)
};

5. 交互:点击 / 拖动 / 松手吸附

gooseTabSel / gooseTabDrag*

点击把“目标分数”设为下标;拖动时分数 = 起点 + 位移÷标签宽;松手四舍五入就近吸附。全部用弹簧动画过渡,所以是“弹”过去的。

// ── 交互:点击 / 拖动,全部由 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 更新选中状态
}

6. 折射与高光(GLSL 着色器)

sampleIndicatorBackdrop()

玻璃里看到的背景,是着色器按 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;
}