目录

实现一个左右抖动的动画效果

问题现象

如何实现一个全局可以使用的左右抖动的动画效果?

背景知识

解决方案

  1. 创建抖动容器组件:使用keyframeAnimateTo关键帧动画通过控制translateX属性,让动画对象在X轴进行平移,实现左右抖动效果。
  2. 设置全局状态:AppStorage.setOrCreate<number>('shakeCount', 0);,便于全局调用该状态。
  3. 将需要设置抖动的页面添加抖动容器组件作为根组件,通过按钮点击事件调用AppStorage.set<number>('shakeCount', count + 1)改变shakeCount的值,触发页面抖动效果。

示例参考如下:

@Entry
@Component
struct ShakeExamplePage {
  build() {
    Column() {
      ShakeContainer() {
        // 原页面内容(如Column/Stack等)
        Column() {
          Text('页面内容').fontSize(20)
          Button('点击').onClick(() => {
            let count = AppStorage.get<number>('shakeCount');
            if (count !== undefined) {
              AppStorage.set<number>('shakeCount', count + 1);
            }
          })
        }
      }
    }
  }
}

const CONFIGURATION: Record<string, number> = {
  'VIBRATION_TIME': 600,
  'ANIMATION_TIME': 100,
  'MARGIN_VERTICAL': 16,
  'FLEX_SHRINK': 1,
  'POPUP_POSITION_X': 8,
  'POPUP_POSITION_Y': 1,
  'MARK_POSITION_X': 4,
  'MARK_POSITION_Y': 9,
  'POSITION_ZERO': 0,
  'POSITION_MINUS_FIVE': -5,
  'OPACITY_VALUE': 0.8,
  'PLAYBACK_COUNT': 2,
  'TRANSLATE_OFFSET_X': 5,
};

@Component
export struct ShakeContainer {
  @Builder
  customBuilder() {
  }

  @BuilderParam content: () => void = this.customBuilder; // 接收页面内容
  @Watch('startAnimation') @StorageLink('shakeCount') shakeCount: number = 0;
  uiContext: UIContext | undefined = undefined;
  @State translateX: number = 0; // 初始化提示文本的偏移量
  private lastTrigger: number = 0;

  aboutToAppear() {
    this.uiContext = this.getUIContext?.();
    if (this.shakeCount > this.lastTrigger) {
      this.lastTrigger = this.shakeCount;
      this.startAnimation(); // 触发动画
    }
  }

  // 触发提示文本抖动动画效果
  startAnimation() {
    if (!this.uiContext) {
      return;
    }
    this.translateX = CONFIGURATION.POSITION_MINUS_FIVE;
    // 通过keyframeAnimateTo关键帧动画指定状态变化过渡动效
    this.uiContext.keyframeAnimateTo({ iterations: CONFIGURATION.PLAYBACK_COUNT }, [
      {
        // 第一段动画时长为100ms,translateX属性从-5到5
        duration: CONFIGURATION.ANIMATION_TIME,
        event: () => {
          this.translateX = CONFIGURATION.TRANSLATE_OFFSET_X;
        }
      },
      {
        // 第二段动画时长为100ms,translateX属性从5到0
        duration: CONFIGURATION.ANIMATION_TIME,
        event: () => {
          this.translateX = CONFIGURATION.POSITION_ZERO;
        }
      }
    ]);
  }

  build() {
    Column() {
      this.content(); // 包裹实际页面内容
    }
    .width('100%')
    .height('100%')
    .backgroundColor(Color.Green)
    .margin({ top: 5 })
    .position({
      x: this.translateX,
      y: CONFIGURATION.POSITION_ZERO
    })
  }
}