文档管理中心
我的
您当前正在浏览新版开发者文档中心,目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标,可切换文档分类。 了解新版目录
指南与API参考指南应用框架ArkUI(方舟UI框架)UI开发 (ArkTS声明式开发范式)使用动画动画衔接

动画衔接

UI界面除了运行动画之外,还承载着与用户进行实时交互的功能。当用户行为根据意图变化发生改变时,UI界面应做到即时响应。例如用户在应用启动过程中,上滑退出,那么启动动画应该立即过渡到退出动画,而不应该等启动动画完成后再退出,从而减少用户等待时间。对于桌面翻页类从跟手到离手触发动画的场景,离手后动画的初始速度应继承手势速度,避免由于速度不连续导致停顿感的产生。针对以上场景,系统已提供动画与动画、手势与动画之间的衔接能力,保证各类场景下动画平稳光滑地过渡的同时,尽可能降低开发难度。

动画与动画的衔接

假设对于某一可动画属性,存在正在运行的动画。当UI侧行为改变该属性终点值时,开发者仅需在animateTo动画闭包中改变属性值或者改变animation接口作用的属性值,即可产生动画。系统会自动衔接之前的动画和当前的动画,开发者仅需要关注当前单次动画的实现。

示例如下。通过点击Click,红色方块的缩放属性会发生变化。当连续快速点击Click时,缩放属性的终点值连续发生变化,当前动画也会平滑过渡到朝着新的缩放属性终点值运动。

收起
自动换行
深色代码主题
复制
  1. import { curves } from '@kit.ArkUI';
  2. class SetAnimationVariables {
  3. isAnimation: boolean = true
  4. set(): void {
  5. this.isAnimation = !this.isAnimation;
  6. }
  7. }
  8. @Entry
  9. @Component
  10. struct AnimationToAnimationDemo {
  11. // 第一步:声明相关状态变量
  12. @State animationController: SetAnimationVariables = new SetAnimationVariables();
  13. build() {
  14. Column() {
  15. Text('ArkUI')
  16. .fontWeight(FontWeight.Bold)
  17. .fontSize(12)
  18. .fontColor(Color.White)
  19. .textAlign(TextAlign.Center)
  20. .borderRadius(10)
  21. .backgroundColor(0xf56c6c)
  22. .width(100)
  23. .height(100)
  24. .scale({
  25. // 第二步:将状态变量设置到相关可动画属性接口
  26. x: this.animationController.isAnimation ? 2 : 1,
  27. y: this.animationController.isAnimation ? 2 : 1
  28. })
  29. .animation({ curve: curves.springMotion(0.4, 0.8) }) // 第四步:通过animation接口开启动画,动画终点值改变时,系统自动添加衔接动画
  30. Button('Click')
  31. .margin({ top: 200 })
  32. .onClick(() => {
  33. // 第三步:通过点击事件改变状态变量值,影响可动画属性值
  34. this.animationController.set()
  35. })
  36. }
  37. .width('100%')
  38. .height('100%')
  39. .justifyContent(FlexAlign.Center)
  40. }
  41. }

手势与动画的衔接

使用滑动、捏合、旋转等手势的场景中,跟手过程中一般会触发属性的改变。离手后,这部分属性往往会继续发生变化,直到到达属性终点值。

离手阶段的属性变化初始速度应与离手前一刻的属性改变速度保持一致。如果离手后属性变化速度从0开始,就好像正在运行的汽车紧急刹车,造成观感上的骤变是用户和开发者都不希望看到的。

针对在触摸事件和动画之间进行衔接的场景(如列表滑动),可以在跟手阶段每一次更改组件属性时,都使用跟手弹簧曲线的属性动画。离手时再用离手弹簧曲线产生离手阶段的属性动画。对于采用springMotion曲线的动画,离手阶段动画将自动继承跟手阶段动画的速度,并以跟手动画当前位置为起点,运动到指定的属性终点。

示例代码如下,小球跟手运动。

收起
自动换行
深色代码主题
复制
  1. import { curves } from '@kit.ArkUI';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. const DOMAIN = 0x0000;
  4. const TAG: string = '[AnimatorTest]';
  5. @Entry
  6. @Component
  7. struct SpringMotionDemo {
  8. // 第一步:声明相关状态变量
  9. @State positionX: number = 100;
  10. @State positionY: number = 100;
  11. diameter: number = 50;
  12. build() {
  13. Column() {
  14. Row() {
  15. Circle({ width: this.diameter, height: this.diameter })
  16. .fill(Color.Blue)
  17. .position({ x: this.positionX, y: this.positionY })// 第二步:将状态变量设置到相关可动画属性接口
  18. .onTouch((event?: TouchEvent) => {
  19. // 第三步:在跟手过程改变状态变量值,并且采用responsiveSpringMotion动画运动到新的值
  20. if (event) {
  21. if (event.type === TouchType.Move) {
  22. // 跟手过程,使用responsiveSpringMotion曲线
  23. this.getUIContext()?.animateTo({ curve: curves.responsiveSpringMotion() }, () => {
  24. // 减去半径,以使球的中心运动到手指位置
  25. this.positionX = event.touches[0].windowX - this.diameter / 2;
  26. this.positionY = event.touches[0].windowY - this.diameter / 2;
  27. hilog.info(DOMAIN, TAG, `move, animateTo x:${this.positionX}, y:${this.positionY}`);
  28. })
  29. } else if (event.type === TouchType.Up) {
  30. // 第四步:在离手过程设定状态变量终点值,并且用springMotion动画运动到新的值,springMotion动画将继承跟手阶段的动画速度
  31. this.getUIContext()?.animateTo({ curve: curves.springMotion() }, () => {
  32. this.positionX = 100;
  33. this.positionY = 100;
  34. hilog.info(DOMAIN, TAG, `touchUp, animateTo x:100, y:100`);
  35. })
  36. }
  37. }
  38. })
  39. }
  40. .width('100%').height('80%')
  41. .clip(true) // 如果球超出父组件范围,使球不可见
  42. .backgroundColor(Color.Orange)
  43. Flex({ direction: FlexDirection.Row, alignItems: ItemAlign.Start, justifyContent: FlexAlign.Center }) {
  44. // 请将$r('app.string.drag')替换为实际资源文件,在本示例中该资源文件的value值为"拖动小球"
  45. Text($r('app.string.drag')).fontSize(16)
  46. }
  47. .width('100%')
  48. Row() {
  49. // 请将$r('app.string.location')替换为实际资源文件,在本示例中该资源文件的value值为"点击位置:"
  50. Text($r('app.string.location') + ' [x: ' + Math.round(this.positionX) + ', y:' + Math.round(this.positionY) + ']').fontSize(16)
  51. }
  52. .padding(10)
  53. .width('100%')
  54. }.height('100%').width('100%')
  55. }
  56. }