Liquid 液态流体
相触即融合的双层液态特效群组
用法
融合
默认 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
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
blur | number | 6 | goo 模糊 σ(px),决定多远开始桥接。 |
contrast | number | 18 | 透明度对比斜率,越大液面边缘越锐。 |
fill | string | '#fff' | 液面颜色,可传 var()。 |
shadow | string | - | box-shadow 语法,画在融合后的剪影上;inset 画在内侧。 |
filterPadding | number | 24 | blob 溢出群组时的滤镜区域余量(px)。 |
插槽
| 插槽名 | Props | 说明 |
|---|---|---|
default | - | 若干 TxLiquidItem。 |
TxLiquidItem
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
effect | 'morph' | 'move' | 'morph' | 液态行为:morph 融合,move 追赶并拖尾。 |
morph | MorphTuning | - | shape / speed / bounce / contentBlur,及 advanced 逃生口。 |
move | MoveTuning | - | springiness / wobble / stretch / trail,及 advanced。 |
dissolve | boolean | number | DissolveOptions | - | 接触熔化修饰;0..1 缩放强度。 |
x / y / scale | number | 0 / 0 / 1 | 组件驱动的位移与缩放,与液面逐像素同步。 |
transition | 'snappy' | 'smooth' | 'bouncy' | SpringConfig | { duration, ease } | 'smooth' | x / y 的弹簧或时长过渡。 |
delay | number | 0 | 过渡延迟(ms),用于交错入场。 |
observe | boolean | false | 让液面跟随自行动画的内容;morph.shape、dissolve、move 已隐含。 |
radius | number | [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 }(CSSlinear(),不支持时回退 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