目录

如何通过手势实现组件惯性滚动动画

问题现象

如何通过PanGesture手势实现自定义组件带有惯性的滑动动画?

效果预览

背景知识

解决方案

  1. 通过PanGesture、SwipeGesture等处理手势事件和animateTo方法配合实现。
  2. 使用PanGesture拖动组件平移,在onActionStart回调中标记手势开始,在onActionUpdate回调中实时更新组件位置,并在onActionEnd回调中记录结束时组件最终位置同时标记手势结束。
  3. 当手指抬起时触发SwipeGesture手势事件中的animateTo动画,计算滑动过程中组件的偏移量,将两者相加得出组件停止状态下的最终坐标位置,从而实现惯性滚动效果。
@Entry
@Component
struct PanGestureExample {
  @State offsetX: number = 0;
  @State offsetY: number = 0;
  @State positionX: number = 0;
  @State positionY: number = 0;
  private panOption: PanGestureOptions = new PanGestureOptions({ direction: PanDirection.All });
  @State isEnd: boolean = false; // 标记手势是否结束
  uiContext: UIContext | undefined = undefined;

  aboutToAppear() {
    this.uiContext = this.getUIContext();
    if (!this.uiContext) {
      console.warn('no uiContext');
      return;
    }
  }

  build() {
    Column() {
      Text('文本滑动');
    }
    .alignItems(HorizontalAlign.Center)
    .justifyContent(FlexAlign.Center)
    .height(60)
    .width(150)
    .backgroundColor('#f1f3f5')
    .borderRadius(12)
    .margin(30)
    .translate({ x: this.offsetX, y: this.offsetY, z: 0 }) // 以组件左上角为坐标原点进行移动
    .gesture(

      GestureGroup(GestureMode.Parallel,
        // 平移手势
        PanGesture(this.panOption) // 手势识别成功的回调
          .onActionStart(() => {
            // 手势开始
            this.isEnd = false;
            console.info('Pan start');
          }) // 手势移动过程中回调
          .onActionUpdate((event?: GestureEvent) => {
            if (event) {
              // 最后的位置加上偏移量
              this.offsetX = this.positionX + event.offsetX;
              this.offsetY = this.positionY + event.offsetY;
            }
          }) // 手势识别成功,手指抬起后触发回调
          .onActionEnd((event) => {
            this.positionX = this.positionX + event.offsetX;
            this.positionY = this.positionY + event.offsetY;
            // 手势结束
            this.isEnd = true;
          }),
        // 滑动手势
        SwipeGesture({ speed: 10 }) // 滑动手势识别成功回调
          .onAction((event) => {
            // 计算惯性滑动的速度
            let speedY = event.speed * Math.sin(Math.sin(event.angle * Math.PI / 180));
            let speedX = event.speed * Math.sin(Math.sin((90 - event.angle) * Math.PI / 180));
            if (this.isEnd) {
              // 设置滑动动画
              this.uiContext?.animateTo({
                duration: 1000,
                curve: Curve.LinearOutSlowIn,
                iterations: 1,
                playMode: PlayMode.Normal,
                onFinish: () => {
                  console.info('play end');
                }
              }, () => {
                this.offsetY = this.offsetY + speedY * 0.1;
                this.positionY = this.positionY + speedY * 0.1;
                this.offsetX = this.offsetX + speedX * 0.1;
                this.positionX = this.positionX + speedX * 0.1;
              });
            }
          })
      )
    );
  }
}