布局更新動(dòng)畫

顯式動(dòng)畫（animateTo）和屬性動(dòng)畫（animation）是ArkUI提供的最基礎(chǔ)和常用的動(dòng)畫功能。在布局屬性（如尺寸屬性、位置屬性）發(fā)生變化時(shí)，可以通過屬性動(dòng)畫或顯式動(dòng)畫，按照動(dòng)畫參數(shù)過渡到新的布局參數(shù)狀態(tài)。

animateTo(value: AnimateParam, event: () => void): void

@Entry
@Component
struct LayoutChange {
  // 用于控制Column的alignItems屬性
  @State itemAlign: HorizontalAlign = HorizontalAlign.Start;
  allAlign: HorizontalAlign[] = [HorizontalAlign.Start, HorizontalAlign.Center, HorizontalAlign.End];
  alignIndex: number = 0;

  build() {
    Column() {
      Column({ space: 10 }) {
        Button("1").width(100).height(50)
        Button("2").width(100).height(50)
        Button("3").width(100).height(50)
      }
      .margin(20)
      .alignItems(this.itemAlign)
      .borderWidth(2)
      .width("90%")
      .height(200)

      Button("click").onClick(() => {
        // 動(dòng)畫時(shí)長為1000ms，曲線為EaseInOut
        animateTo({ duration: 1000, curve: Curve.EaseInOut }, () => {
          this.alignIndex = (this.alignIndex + 1) % this.allAlign.length;
          // 在閉包函數(shù)中修改this.itemAlign參數(shù)，使Column容器內(nèi)部孩子的布局方式變化，使用動(dòng)畫過渡到新位置
          this.itemAlign = this.allAlign[this.alignIndex];
        });
      })
    }
    .width("100%")
    .height("100%")
  }
}

除直接改變布局方式外，也可直接修改組件的寬、高、位置。

@Entry
@Component
struct LayoutChange2 {
  @State myWidth: number = 100;
  @State myHeight: number = 50;
  // 標(biāo)志位，true和false分別對(duì)應(yīng)一組myWidth、myHeight值
  @State flag: boolean = false;

  build() {
    Column({ space: 10 }) {
      Button("text")
        .type(ButtonType.Normal)
        .width(this.myWidth)
        .height(this.myHeight)
        .margin(20)
      Button("area: click me")
        .fontSize(12)
        .margin(20)
        .onClick(() => {
          animateTo({ duration: 1000, curve: Curve.Ease }, () => {
            // 動(dòng)畫閉包中根據(jù)標(biāo)志位改變控制第一個(gè)Button寬高的狀態(tài)變量，使第一個(gè)Button做寬高動(dòng)畫
            if (this.flag) {
              this.myWidth = 100;
              this.myHeight = 50;
            } else {
              this.myWidth = 200;
              this.myHeight = 100;
            }
            this.flag = !this.flag;
          });
        })
    }
    .width("100%")
    .height("100%")
  }
}

在第二個(gè)Button的點(diǎn)擊事件中，使用animateTo函數(shù)，在閉包中修改this.myWidth和this.myHeight狀態(tài)變量，而這兩個(gè)狀態(tài)變量分別為第一個(gè)Button的寬、高屬性值，所以第一個(gè)Button做了寬高動(dòng)畫。效果如下圖。

與此同時(shí)，第二個(gè)Button也產(chǎn)生了一個(gè)位置動(dòng)畫。這是由于第一個(gè)Button的寬高變化后，引起了Column內(nèi)部其他組件的布局結(jié)果也發(fā)生了變化，第二個(gè)Button的布局發(fā)生變化也是由于閉包內(nèi)改變第一個(gè)Button的寬高造成的。

如果不希望第二個(gè)Button有動(dòng)畫效果，有兩種方式可以實(shí)現(xiàn)。一種是給做第一個(gè)Button外面再加一個(gè)容器，使其動(dòng)畫前后的大小都在容器的范圍內(nèi)，這樣第二個(gè)Button的位置不會(huì)被第一個(gè)Button的位置所影響。修改后的核心代碼如下。

Column({ space: 10 }) {
  Column() {
    // Button放在足夠大的容器內(nèi)，使其不影響更外層的組件位置
    Button("text")
      .type(ButtonType.Normal)
      .width(this.myWidth)
      .height(this.myHeight)
  }
  .margin(20)
  .width(200)
  .height(100)

  Button("area: click me")
    .fontSize(12)
    .onClick(() => {
      animateTo({ duration: 1000, curve: Curve.Ease }, () => {
        // 動(dòng)畫閉包中根據(jù)標(biāo)志位改變控制第一個(gè)Button寬高的狀態(tài)變量，使第一個(gè)Button做寬高動(dòng)畫
        if (this.flag) {
          this.myWidth = 100;
          this.myHeight = 50;
        } else {
          this.myWidth = 200;
          this.myHeight = 100;
        }
        this.flag = !this.flag;
      });
    })
}
.width("100%")
.height("100%")

另一種方式是給第二個(gè)Button添加布局約束，如position的位置約束，使其位置不被第一個(gè)Button的寬高影響。核心代碼如下：

Column({ space: 10 }) {
  Button("text")
    .type(ButtonType.Normal)
    .width(this.myWidth)
    .height(this.myHeight)
    .margin(20)

  Button("area: click me")
    .fontSize(12)
    // 配置position屬性固定，使自己的布局位置不被第一個(gè)Button的寬高影響
    .position({ x: "30%", y: 200 })
    .onClick(() => {
      animateTo({ duration: 1000, curve: Curve.Ease }, () => {
        // 動(dòng)畫閉包中根據(jù)標(biāo)志位改變控制第一個(gè)Button寬高的狀態(tài)變量，使第一個(gè)Button做寬高動(dòng)畫
        if (this.flag) {
          this.myWidth = 100;
          this.myHeight = 50;
        } else {
          this.myWidth = 200;
          this.myHeight = 100;
        }
        this.flag = !this.flag;
      });
    })
}
.width("100%")
.height("100%")

animation(value: AnimateParam)

@Entry
@Component
struct LayoutChange2 {
  @State myWidth: number = 100;
  @State myHeight: number = 50;
  @State flag: boolean = false;
  @State myColor: Color = Color.Blue;

  build() {
    Column({ space: 10 }) {
      Button("text")
        .type(ButtonType.Normal)
        .width(this.myWidth)
        .height(this.myHeight)
        // animation只對(duì)其上面的type、width、height屬性生效，時(shí)長為1000ms，曲線為Ease
        .animation({ duration: 1000, curve: Curve.Ease })
        // animation對(duì)下面的backgroundColor、margin屬性不生效
        .backgroundColor(this.myColor)
        .margin(20)
        

      Button("area: click me")
        .fontSize(12)
        .onClick(() => {
          // 改變屬性值，配置了屬性動(dòng)畫的屬性會(huì)進(jìn)行動(dòng)畫過渡
          if (this.flag) {
            this.myWidth = 100;
            this.myHeight = 50;
            this.myColor = Color.Blue;
          } else {
            this.myWidth = 200;
            this.myHeight = 100;
            this.myColor = Color.Pink;
          }
          this.flag = !this.flag;
        })
    }
  }
}

上述示例中，第一個(gè)button上的animation屬性，只對(duì)寫在animation之前的type、width、height屬性生效，而對(duì)寫在animation之后的backgroundColor、margin屬性無效。運(yùn)行結(jié)果是width、height屬性會(huì)按照animation的動(dòng)畫參數(shù)執(zhí)行動(dòng)畫，而backgroundColor會(huì)直接跳變，不會(huì)產(chǎn)生動(dòng)畫。效果如下圖：