useReducedMotion() | () => Ref<boolean> | 跟随系统 prefers-reduced-motion 的响应式偏好,挂载与 KeepAlive 激活时监听 |
useFlip(targetRef, opts?) | (ref, opts?) => UseFlipReturn | 对元素做 FLIP 过渡(TxFlipOverlay 底层) |
useAutoResize(targetRef, opts?) | (ref, opts?) => UseAutoResizeReturn | 测量尺寸变化并过渡(TxAutoSizer 底层) |
stepSpring(position, velocity, target, spring, dt) | (position, velocity, target, spring, dt) => [number, number] | 在自有帧循环中沿弹簧推进数值(spring 为 { stiffness, damping, mass? },dt 以秒计),换目标时保留速度;可作 useJellyIndicator glide 的 integrate |
solveSpring(position, velocity, target, spring, t) | (position, velocity, target, spring, t) => [number, number] | 同一弹簧的闭式解:任意时刻 t(秒)的精确位置与速度;用于可拖动时间线、逐帧渲染和断言某一时刻的位置 |
createSpringTrack(spring, initial) | (spring, initial) => { retarget(t, target), sample(t) } | 可中途换目标的弹簧轨道:换目标时保留当时的位置与速度,sample(t) 可按任意顺序精确读取 |
useMorphBox(box, content, opts?) | (box, content, opts?) => { morphing, settle } | 容器跟随内容自然尺寸做弹簧过渡,途中再变保留速度;TxMorph 与 TxTransitionSmoothSize 的尺寸引擎 |
useIndicatorBox(options) | (options) => UseIndicatorBoxReturn | 测量目标相对容器的位置与尺寸,供滑动指示器跟随,并用 ResizeObserver 保持同步 |
useJellyIndicator(options?) | (options?) => UseJellyIndicatorReturn | 驱动滑动指示器的弹簧引擎,支持 jelly 与 glide 两种材质;测量与绘制由宿主负责 |
resolveGsapEase(value) | (value: string) => string | ((t: number) => number) | 交给 GSAP 前转换缓动:spring(...)、cubic-bezier(...) 转为进度函数(GSAP 不认识,会静默换成默认缓动),GSAP 缓动名原样返回 |
resolveCssEase(spec) | (spec: string | undefined | null) => (t: number) => number | 在 JS 中按 CSS 缓动求值:cubic-bezier(...)、等距 linear(...) 与 linear / ease / ease-in / ease-out / ease-in-out;其他写法退化为钳制线性,从不返回 null;按写法缓存,可逐帧调用 |
createSpringEase(omega?, zeta?) | (omega = 10, zeta = 0.72) => (t: number) => number | 按时间线归一化的闭式欠阻尼弹簧:冲过 1 再回落,终点恰为 1;与逐帧积分的 stepSpring 不同,可直接当 ease 用 |
parseSpringEase(value) | (value: string | undefined | null) => ((t: number) => number) | null | 解析 spring / spring(omega) / spring(omega, zeta),其他写法返回 null |
createCubicBezier(x1, y1, x2, y2) | (x1, y1, x2, y2) => (t: number) => number | 等价于 CSS cubic-bezier();图表入口的 cubicBezier 即此函数 |
parseCubicBezier(value) | (value: string | undefined | null) => [number, number, number, number] | null | 解析 cubic-bezier(...);GSAP 缓动名、关键字、弹簧写法,或 x 控制点超出 0, 1 时返回 null |
applyThemeTransition(updateTheme, options?) | (updateTheme, options?) => Promise<void> | void | 通过 View Transitions API 执行平滑主题切换(柔和模糊圆、斜切光刃、横向扫光等),详见《Theming 主题定制》 |