目录

解决修改文本宽度缺乏过渡动画的问题

问题现象

当通过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);
  }
}

总结

通过@AnimatableExtend将布局属性转换为可插值的动画属性,使系统能在每一帧计算中间值,实现宽度与文字显示的同步过渡。这本质是将CSS属性提升到动画管线层处理,避免布局与动画的时序冲突。