组件/Liquid 液态流体

Liquid 液态流体

相触即融合的双层液态特效群组

Verified自 0.3.9

用法

融合

默认 effect="morph":给条目 x / y,元素与液面同步动画,相触的块像水滴一样融合。

Loading demo...

形变物理

morph.shape 开启形变:质心先流向新位置,尺寸与圆角随后跟上,内容在运动中模糊、落定后清晰。

<template>
  <TxLiquid :blur="8" fill="var(--tx-bg-color)">
    <TxLiquidItem :morph="{ shape: true, speed: 1, bounce: 0.5 }">
      <div :class="open ? 'panel-open' : 'panel-closed'">…</div>
    </TxLiquidItem>
  </TxLiquid>
</template>

溶解

dissolve 与 effect 正交:接触处,条目的图像经湍流位移熔进邻居,而不是模糊;文字不会被熔化。

<template>
  <TxLiquid :blur="10" fill="var(--tx-bg-color)">
    <TxLiquidItem dissolve>
      <img class="avatar" src="/a.png" alt="">
    </TxLiquidItem>
    <TxLiquidItem :dissolve="{ mix: 0.7, active: dragging }">
      <img class="avatar" src="/b.png" alt="">
    </TxLiquidItem>
  </TxLiquid>
</template>

拖尾

effect="move":自行移动元素(CSS、指针事件均可),液面在弹簧上追赶,并拖出水滴尾巴。

Loading demo...

最佳实践

  • 条目背景保持透明,液面即表面;不透明内容(如圆形照片)恰好盖住自己的液面。
  • fill 传 CSS 变量(如 var(--tx-bg-color)),让液面随主题切换。
  • 阴影写在 shadow 上而不是子元素上,才能贴着融合后的液面。
  • 该融合却分离时,先调大 blur,再查其他参数。
  • 高频拖拽先用 effect="move" 的默认参数,不够再用 advanced。

API 参考

TxLiquid

属性

属性名类型默认值说明
blurnumber6goo 模糊 σ(px),决定多远开始桥接。
contrastnumber18透明度对比斜率,越大液面边缘越锐。
fillstring'#fff'液面颜色,可传 var()。
shadowstring-box-shadow 语法,画在融合后的剪影上;inset 画在内侧。
filterPaddingnumber24blob 溢出群组时的滤镜区域余量(px)。

插槽

插槽名Props说明
default-若干 TxLiquidItem。

TxLiquidItem

属性

属性名类型默认值说明
effect'morph' | 'move''morph'液态行为:morph 融合,move 追赶并拖尾。
morphMorphTuning-shape / speed / bounce / contentBlur,及 advanced 逃生口。
moveMoveTuning-springiness / wobble / stretch / trail,及 advanced。
dissolveboolean | number | DissolveOptions-接触熔化修饰;0..1 缩放强度。
x / y / scalenumber0 / 0 / 1组件驱动的位移与缩放,与液面逐像素同步。
transition'snappy' | 'smooth' | 'bouncy' | SpringConfig | { duration, ease }'smooth'x / y 的弹簧或时长过渡。
delaynumber0过渡延迟(ms),用于交错入场。
observebooleanfalse让液面跟随自行动画的内容;morph.shape、dissolve、move 已隐含。
radiusnumber | [tl, tr, br, bl]测量值覆盖从计算样式测得的圆角。

插槽

插槽名Props说明
default-可交互的真实内容,背景保持透明。

概述

  • TxLiquid 是 isolation: isolate 的相对定位容器:剪影 SVG 垫在所有子元素之下,熔化叠层在内容之上,两者都不接收指针事件。
  • TxLiquidItem 必须位于 TxLiquid 内,否则抛错。
  • 群组尺寸需容纳条目的完整行程;桥接约在 blur ≳ 间距 时发生。
  • 组件独占包装器的 transform(x/y/scale)、运动中内容的 filter(morph.shape)与 <img> 的 mask-image(dissolve),不要再写同名样式。
  • dissolve 与 effect="move" 同用时被忽略并告警;减少动态效果时,组件驱动的过渡变为瞬移。
  • 入口另导出 resolveTransition(transition, reducedMotion?) 与 liquidTransitionPresets,把预设或 SpringConfig 编译为 { duration, easing }(CSS linear(),不支持时回退 cubic-bezier),供组件外的 WAAPI / CSS 动效复用。

技术实现

  • 剪影层用 SVG goo 滤镜(高斯模糊 + 透明度对比)融合各条目的 blob;内容层不经滤镜,保持清晰可交互。
  • 移植自 Jakubantalik/Libraries · liquid-gooey(MIT © Jakub Antalik),React 的 Liquid / Liquid.Item 对应 TxLiquid / TxLiquidItem。
  • 源码:packages/tuffex/packages/components/src/liquid/。
查看源码
packages/tuffex/packages/components/src/liquid/index.ts