ResizeBox 显式尺寸动画
在显式宽高目标之间过渡的容器
用法
显式尺寸目标
父组件给出 width / height 目标;resize-start / resize-end 标记一次过渡的开始与结束。
Loading demo...
最佳实践
- 父组件已知紧凑与展开目标时用
TxResizeBox;图片、异步渲染、换行等内容驱动的变化改用TxAutoSizer。 - 只设置自己控制的轴,未设置的轴保持固有尺寸。
- 响应式目标用
min(420px, 100%)这类 CSS 长度,避免窄屏横向溢出。 - 内容大于紧凑目标时保留
clip;只有溢出是有意设计时才关闭。 resize-start/resize-end只作生命周期通知,尺寸以 props 为准。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
as | string | div | 根元素标签;透传的 attrs、class、style 落在根元素上。 |
width | number | string | undefined | 宽度目标:有限数字按 px,非空字符串作为 CSS 长度;未设置时保持固有宽度。 |
height | number | string | undefined | 高度目标,规则同 width。 |
duration | number | 300 | 宽高过渡时长(ms)。 |
easing | string | cubic-bezier(0.22, 1, 0.36, 1) | 宽高过渡共用的缓动。 |
disabled | boolean | false | 去掉过渡,新目标立即生效;调整中禁用会结束当前生命周期。 |
clip | boolean | true | 在根元素上应用 overflow: hidden。 |
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
resize-start | () | 启用动画时尺寸目标变化即触发;动画中的连续变化属于同一生命周期。 |
resize-end | () | 最后一个宽高过渡完成、安全定时器到期或调整中被禁用时触发。 |
插槽
| 插槽名 | 参数 | 说明 |
|---|---|---|
default | - | 直接渲染在根元素内的内容,不额外包裹或测量。 |
暴露方法
| 名称 | 类型 | 说明 |
|---|---|---|
rootEl | HTMLElement | null | 当前根元素。 |
animating | boolean | 是否处于尺寸过渡生命周期中。 |
概述
- 有限数字转为 px;非空字符串原样保留,可直接用
%、rem、calc()、min()。undefined、null、非有限数字与空白字符串表示该轴不设置。 - 组件不校验 CSS 长度:负数与无效字符串照样交给浏览器;没有过渡实际运行时,安全定时器仍会结束生命周期。
- 只响应根元素自身的
width/height过渡,子元素与其他属性的 transition 事件被忽略。 disabled时目标变化立即跳变,不触发事件;减少动态效果时过渡缩短到0.01ms,生命周期照常结束。- 只改插槽内容不会触发尺寸调整;组件没有内容测量、
ResizeObserver或v-model。
技术实现
- 尺寸变化交给根元素的 CSS
transition,生命周期由transitionend与按时长计算的安全定时器结束。 - 源码:
packages/tuffex/packages/components/src/resize-box/。
查看源码
packages/tuffex/packages/components/src/resize-box/index.ts