当通过animateTo实现宽度缩放动画(300px变化为50px)时,文字会立即被截断显示为"文…",随后才开始进行宽度过渡动画,动画过程中文字始终处于截断状态,视觉体验不连贯。问题代码示例参考如下:
@Entry
@Component
struct AnimateToExample {
@State textWidth: Length = 300;
@State flag: boolean = true;
private onClick2Animate() {
this.getUIContext().animateTo({
duration: 3000,
curve: Curve.Linear,
playMode: PlayMode.Normal,
onFinish: () => {
console.info('play end')
}
}, () => {
this.textWidth = this.flag ? 50 : 200;
this.flag = !this.flag
})
}
build() {
Column() {
Text('文案文案文案文案文案文案文案')
.width(this.textWidth)
.maxLines(1)
.textOverflow({ overflow: TextOverflow.Ellipsis })
.fontSize(18)
.height(30)
.backgroundColor('#f1f3f5')
.padding(5)
.textAlign(TextAlign.Center)
.onClick(() => {
this.onClick2Animate()
})
}.width('100%').height('100%').justifyContent(FlexAlign.Center)
}
} 问题效果预览:

根本原因在于:闭包内的width赋值立即生效,触发文本截断,animateTo只能对已注册的可动画属性产生过渡效果,width属性不具备逐帧动画能力。
// 问题代码
this.getUIContext.animateTo({...}, () => {
this.textWidth = 50; // 同步触发重排
}) 使用AnimatableExtend装饰器,通过逐帧修改width实现平滑过渡,避免布局更新优先于动画执行。
// 使用@AnimatableExtend装饰器,自定义可动画属性接口
@AnimatableExtend(Text)
function animatableWidth(width: number) {
// 调用系统属性接口,逐帧回调函数每帧修改可动画属性的值,实现逐帧布局的效果
.width(width);
}
@Entry
@Component
struct AnimateDemo {
@State textWidth: number = 300;
build() {
Column() {
Text('文案文案文案文案文案文案文案文案文案文案文案文案文案文案文案文案文案')
// 将自定义可动画属性接口设置到组件上
.animatableWidth(this.textWidth)
.maxLines(1)
.textOverflow({ overflow: TextOverflow.Ellipsis })
.fontSize(18)
.height(30)
.backgroundColor('#f1f3f5')
.padding(5)
.textAlign(TextAlign.Center)
// 为自定义可动画属性接口绑定动画
.animation({ duration: 2000, curve: Curve.Ease })
.onClick(() => {
// 改变自定义可动画属性的参数,产生动画
this.textWidth = this.textWidth === 300 ? 50 : 300;
});
}
.width('100%').height('100%').justifyContent(FlexAlign.Center);
}
}