页面间转场

2024-01-22 18:18 更新

在全局pageTransition方法内配置页面入场和页面退场时的自定义转场动效。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

名称

参数

必填

参数描述

PageTransitionEnter

{

type?: RouteType,

duration?: number,

curve?: Curve | string,

delay?: number

}

设置当前页面的自定义入场动效。

- type:页面转场效果生效的路由类型。

默认值:RouteType.None

- duration:动画的时长。

单位:毫秒。

- curve:动画曲线。string类型的取值支持"ease"、"ease-in"、"ease-out"、"ease-in-out"、"extreme-deceleration"、"fast-out-linear-in"、"fast-out-slow-in"、"friction"、"linear"、"linear-out-slow-in"、"rhythm"、"sharp"、"smooth"。

默认值:Curve.Linear

- delay:动画延迟时长。

单位:毫秒

默认值:0,默认不延迟播放。

说明:

没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。

PageTransitionExit

{

type?: RouteType,

duration?: number,

curve?: Curve | string,

delay?: number

}

设置当前页面的自定义退场动效。

- type:页面转场效果生效的路由类型。

默认值:RouteType.None。

- duration:动画的时长,单位为毫秒。

- curve:动画曲线,string类型取值与PageTransitionEnter相同。

默认值:Curve.Linear

- delay:动画延迟时长,单位为毫秒,默认不延迟播放。

默认值:0

单位:毫秒

说明:

没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。

RouteType枚举说明

名称

描述

Pop

重定向指定页面。从PageB回退到之前的页面PageA。对于PageB,指定RouteType为None或者Pop的PageTransitionExit组件样式生效,对于PageA,指定RouteType为None或者Pop的PageTransitionEnter组件样式生效。

Push

跳转到下一页面。PageA跳转到下一个新的界面PageB。对于PageA,指定RouteType为None或者Push的PageTransitionExit组件样式生效,对于PageB,指定RouteType为None或者Push的PageTransitionEnter组件样式生效。

None

页面未重定向。如Push和Pop描述中RouteType为None的情形,即页面进场时PageTransitionEnter的转场效果生效;退场时PageTransitionExit的转场效果生效。

属性

参数名称

参数

必填

参数描述

slide

SlideEffect

设置页面转场时的滑入滑出效果。

默认值:SlideEffect.Right

translate

{

x? : number | string,

y? : number | string,

z? : number | string

}

设置页面转场时的平移效果,为入场时起点和退场时终点的值,和slide同时设置时默认生效slide。

- x:横向的平移距离。

- y:纵向的平移距离。

- z:竖向的平移距离。

scale

{

x? : number,

y? : number,

z? : number,

centerX? : number | string,

centerY? : number | string

}

设置页面转场时的缩放效果,为入场时起点和退场时终点的值。

- x:横向放大倍数(或缩小比例)。

- y:纵向放大倍数(或缩小比例)。

- z:竖向放大倍数(或缩小比例)。

- centerX、centerY缩放中心点。

- 中心点为0时,默认的是组件的左上角。

opacity

number

设置入场的起点透明度值或者退场的终点透明度值。

默认值:1

SlideEffect枚举说明

名称

描述

Left

设置到入场时表示从左边滑入,出场时表示滑出到左边。

Right

设置到入场时表示从右边滑入,出场时表示滑出到右边。

Top

设置到入场时表示从上边滑入,出场时表示滑出到上边。

Bottom

设置到入场时表示从下边滑入,出场时表示滑出到下边。

事件

事件

功能描述

onEnter(event: (type?: RouteType, progress?: number) => void)

回调入参为当前入场动画的归一化进度[0 - 1]。

- type:跳转方法。

- progress:当前进度。

触发该事件的条件:逐帧回调,直到入场动画结束,progress从0变化到1。

onExit(event: (type?: RouteType, progress?: number) => void)

回调入参为当前退场动画的归一化进度[0 - 1]。

- type:跳转方法。

- progress:当前进度。

触发该事件的条件:逐帧回调,直到退场动画结束,progress从0变化到1。

示例

自定义方式1:配置了当前页面的入场动画为淡入,退场动画为缩小。

  1. // index.ets
  2. @Entry
  3. @Component
  4. struct PageTransitionExample1 {
  5. @State scale1: number = 1
  6. @State opacity1: number = 1
  7. build() {
  8. Column() {
  9. Navigator({ target: 'pages/page1', type: NavigationType.Push }) {
  10. Image($r('app.media.bg1')).width('100%').height('100%') // 图片存放在media文件夹下
  11. }
  12. }.scale({ x: this.scale1 }).opacity(this.opacity1)
  13. }
  14. // 自定义方式1:完全自定义转场过程的效果
  15. pageTransition() {
  16. PageTransitionEnter({ duration: 1200, curve: Curve.Linear })
  17. .onEnter((type: RouteType, progress: number) => {
  18. this.scale1 = 1
  19. this.opacity1 = progress
  20. }) // 进场过程中会逐帧触发onEnter回调,入参为动效的归一化进度(0% -- 100%)
  21. PageTransitionExit({ duration: 1500, curve: Curve.Ease })
  22. .onExit((type: RouteType, progress: number) => {
  23. this.scale1 = 1 - progress
  24. this.opacity1 = 1
  25. }) // 退场过程中会逐帧触发onExit回调,入参为动效的归一化进度(0% -- 100%)
  26. }
  27. }
  1. // page1.ets
  2. @Entry
  3. @Component
  4. struct AExample {
  5. @State scale2: number = 1
  6. @State opacity2: number = 1
  7. build() {
  8. Column() {
  9. Navigator({ target: 'pages/index', type: NavigationType.Push }) {
  10. Image($r('app.media.bg2')).width('100%').height('100%') // 图片存放在media文件夹下
  11. }
  12. }.width('100%').height('100%').scale({ x: this.scale2 }).opacity(this.opacity2)
  13. }
  14. // 自定义方式1:完全自定义转场过程的效果
  15. pageTransition() {
  16. PageTransitionEnter({ duration: 1200, curve: Curve.Linear })
  17. .onEnter((type: RouteType, progress: number) => {
  18. this.scale2 = 1
  19. this.opacity2 = progress
  20. }) // 进场过程中会逐帧触发onEnter回调,入参为动效的归一化进度(0% -- 100%)
  21. PageTransitionExit({ duration: 1500, curve: Curve.Ease })
  22. .onExit((type: RouteType, progress: number) => {
  23. this.scale2 = 1 - progress
  24. this.opacity2 = 1
  25. }) // 退场过程中会逐帧触发onExit回调,入参为动效的归一化进度(0% -- 100%)
  26. }
  27. }

自定义方式2:配置了当前页面的入场动画为从左侧滑入,退场为缩小加透明度变化。

  1. // index.ets
  2. @Entry
  3. @Component
  4. struct PageTransitionExample {
  5. @State scale1: number = 1
  6. @State opacity1: number = 1
  7. build() {
  8. Column() {
  9. Navigator({ target: 'pages/page1', type: NavigationType.Push }) {
  10. Image($r('app.media.bg1')).width('100%').height('100%') // 图片存放在media文件夹下
  11. }
  12. }.scale({ x: this.scale1 }).opacity(this.opacity1)
  13. }
  14. // 自定义方式2:使用系统提供的多种默认效果(平移、缩放、透明度等)
  15. pageTransition() {
  16. PageTransitionEnter({ duration: 1200 })
  17. .slide(SlideEffect.Left)
  18. PageTransitionExit({ delay: 100 })
  19. .translate({ x: 100.0, y: 100.0 })
  20. .opacity(0)
  21. }
  22. }
  1. // page1.ets
  2. @Entry
  3. @Component
  4. struct PageTransitionExample1 {
  5. @State scale2: number = 1
  6. @State opacity2: number = 1
  7. build() {
  8. Column() {
  9. Navigator({ target: 'pages/index', type: NavigationType.Push }) {
  10. Image($r('app.media.bg2')).width('100%').height('100%') // 图片存放在media文件夹下
  11. }
  12. }.scale({ x: this.scale2 }).opacity(this.opacity2)
  13. }
  14. // 自定义方式2:使用系统提供的多种默认效果(平移、缩放、透明度等)
  15. pageTransition() {
  16. PageTransitionEnter({ duration: 1200 })
  17. .slide(SlideEffect.Left)
  18. PageTransitionExit({ delay: 100 })
  19. .translate({ x: 100.0, y: 100.0 })
  20. .opacity(0)
  21. }
  22. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号