温馨提示：本篇博客的详细代码已发布到 git : https://gitcode.com/nutpi/HarmonyosNext 可以下载运行哦！

HarmonyOS NEXT 跑马灯组件详解(四)：动画实现机制

效果演示

1. 动画实现概述

MarqueeSection组件的核心是其动画实现，主要通过scrollAnimation方法来控制文本的滚动效果。

2. scrollAnimation方法详解

scrollAnimation() {
    // 判断是否需要滚动
    if (this.ticketCheckTextWidth < this.ticketCheckScrollWidth) {
        return;
    }
    
    // 执行动画
    animateTo({
        duration: this.marqueeAnimationModifier.duration,
        tempo: this.marqueeAnimationModifier.tempo,
        curve: Curve.Linear,
        onFinish: () => {
            // 动画完成后的处理
            this.handleAnimationComplete();
        }
    }, () => {
        // 设置文本偏移量
        this.setTextOffset();
    })
}

3. 动画参数解析

3.1 基本参数

animateTo({
    duration: this.marqueeAnimationModifier.duration,  // 持续时间
    tempo: this.marqueeAnimationModifier.tempo,       // 播放速度
    curve: Curve.Linear,                              // 动画曲线
})

参数说明：

• duration：动画持续时间（毫秒）
• tempo：动画速度系数
• curve：动画曲线类型

3.2 回调函数

onFinish: () => {
    // 重置偏移量
    this.ticketCheckTextOffset = this.calculateResetOffset();
    
    // 处理循环逻辑
    if (this.shouldContinueAnimation()) {
        this.scheduleNextAnimation();
    }
}

4. 偏移量计算

4.1 初始偏移量

this.ticketCheckTextOffset = this.marqueeAnimationModifier.playMode === PlayMode.Normal ? 
    0 : 
    -(2 * this.ticketCheckTextWidth + this.marqueeScrollModifier.space - this.ticketCheckScrollWidth);

4.2 动画偏移量

this.ticketCheckTextOffset = this.marqueeAnimationModifier.playMode === PlayMode.Normal ?
    -(this.ticketCheckTextWidth + this.marqueeScrollModifier.space) :
    -(this.ticketCheckTextWidth - this.ticketCheckScrollWidth)

5. 循环控制

5.1 循环次数控制

if (this.marqueeAnimationModifier.iterations > 1) {
    if (this.count === this.marqueeAnimationModifier.iterations) {
        this.count = 1;
        return;
    }
    this.count++;
} else if (this.marqueeAnimationModifier.iterations === 0 || 
           this.marqueeAnimationModifier.iterations === 1) {
    return;
}

5.2 延时处理

this.timer = setTimeout(() => {
    this.scrollAnimation();
}, this.marqueeAnimationModifier.delayTime)

6. 性能优化

6.1 条件渲染

if (this.ticketCheckTextWidth < this.ticketCheckScrollWidth) {
    return;  // 文本宽度小于容器宽度时不执行动画
}

6.2 定时器管理

aboutToAppear(): void {
    clearTimeout(this.timer);  // 组件出现时清除可能存在的定时器
}

7. 动画效果调优

7.1 播放模式设置

PlayMode.Normal    // 正常播放
PlayMode.Reverse   // 反向播放

7.2 动画曲线

curve: Curve.Linear  // 线性动画，保持匀速滚动

8. 最佳实践

1. 动画参数设置

new MarqueeAnimationModifier(
    -1,     // 无限循环
    5000,   // 5秒一次
    1.0,    // 正常速度
    PlayMode.Normal,
    1000    // 1秒延迟
)

1. 性能考虑

// 避免不必要的动画
if (!this.needAnimation()) {
    return;
}

// 清理资源
aboutToDisappear() {
    clearTimeout(this.timer);
}

1. 错误处理

try {
    this.scrollAnimation();
} catch (error) {
    logger.error('Animation error:', error.toString());
}

9. 注意事项

1. 动画性能

   • 避免过于频繁的动画
   • 合理设置动画时间
   • 注意内存占用

2. 定时器管理

   • 及时清除定时器
   • 避免定时器泄漏
   • 合理设置延时时间

3. 状态同步

   • 确保状态更新及时
   • 避免状态冲突
   • 处理边界情况

通过以上详细讲解，你应该能够理解MarqueeSection组件的动画实现机制。合理使用这些动画特性可以创建流畅的文本滚动效果。