1# 页面间转场 2 3当路由进行切换时，可以通过在pageTransition函数中自定义页面入场和页面退场的转场动效。详细指导请参考[页面转场动画](../../ui/arkts-page-transition-animation.md)。 4 5> **说明：** 6> 7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8> 9> 为了实现更好的转场效果，推荐使用[Navigation组件](../../ui/arkts-navigation-navigation.md)和[模态转场](../../ui/arkts-modal-transition.md)。 10 11 12| 名称 | 参数 | 必填 | 参数描述 | 13| ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 14| PageTransitionEnter | {<br/>type?: [RouteType](#routetype枚举说明)e,<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve) \| string \| [ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br>delay?: number<br/>} | 否 | 设置当前页面的自定义入场动效。<br/>- type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>- duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>- 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"。<br/>默认值：Curve.Linear<br/>- delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 | 15| PageTransitionExit | {<br/>type?: [RouteType](#routetype枚举说明),<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve) \| string \| [ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br/>delay?: number<br/>} | 否 | 设置当前页面的自定义退场动效。<br/>- type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>- duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>- curve：动画曲线，string类型取值与PageTransitionEnter相同。<br/> 默认值：Curve.Linear<br/>- delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 | 16 17## RouteType枚举说明 18 19| 名称 | 描述 | 20| ---- | ------------------------------------------------------------ | 21| Pop | 重定向指定页面。从PageB回退到之前的页面PageA。对于PageB，指定RouteType为None或者Pop的PageTransitionExit组件样式生效，对于PageA，指定RouteType为None或者Pop的PageTransitionEnter组件样式生效。 | 22| Push | 跳转到下一页面。PageA跳转到下一个新的界面PageB。对于PageA，指定RouteType为None或者Push的PageTransitionExit组件样式生效，对于PageB，指定RouteType为None或者Push的PageTransitionEnter组件样式生效。 | 23| None | 页面未重定向。如Push和Pop描述中RouteType为None的情形，即页面进场时PageTransitionEnter的转场效果生效；退场时PageTransitionExit的转场效果生效。 | 24 25 26## 属性 27 28| 参数名称 | 参数类型 | 必填 | 参数描述 | 29| --------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 30| slide | [SlideEffect](#slideeffect枚举说明) | 否 | 设置页面转场时的滑入滑出效果。 | 31| translate | {<br/>x? : number \| string,<br/>y? : number \| string,<br/>z? : number \| string<br/>} | 否 | 设置页面转场时的平移效果，为入场时起点和退场时终点的值，和slide同时设置时默认生效slide。<br/>- x：横向的平移距离。<br/>- y：纵向的平移距离。<br/>- z：竖向的平移距离。 | 32| scale | {<br/>x? : number,<br/>y? : number,<br/>z? : number,<br/>centerX? : number \| string,<br/>centerY? : number \| string<br/>} | 否 | 设置页面转场时的缩放效果，为入场时起点和退场时终点的值。<br/>- x：横向放大倍数（或缩小比例）。<br/>- y：纵向放大倍数（或缩小比例）。<br/>- z：竖向放大倍数（或缩小比例）。<br/>- centerX、centerY缩放中心点。centerX和centerY默认值是"50%"，即默认以页面的中心点为旋转中心点。<br/>- 中心点为(0, 0)代表页面的左上角。<br/> | 33| opacity | number | 否 | 设置入场的起点透明度值或者退场的终点透明度值。 | 34 35## SlideEffect枚举说明 36 37| 名称 | 描述 | 38| ------ | ------------------------- | 39| Left | 设置到入场时表示从左边滑入，出场时表示滑出到左边。 | 40| Right | 设置到入场时表示从右边滑入，出场时表示滑出到右边。 | 41| Top | 设置到入场时表示从上边滑入，出场时表示滑出到上边。 | 42| Bottom | 设置到入场时表示从下边滑入，出场时表示滑出到下边。 | 43 44 45## 事件 46 47| 事件 | 功能描述 | 48| ------------------------------------------------------------ | ------------------------------------------------------------ | 49| onEnter(event: (type?: RouteType, progress?: number) => void) | 回调入参为当前入场动画的归一化进度[0 - 1]。<br/>- type：跳转方法。<br/>- progress：当前进度。<br/>触发该事件的条件：<br/>逐帧回调，直到入场动画结束，progress从0变化到1。 | 50| onExit(event: (type?: RouteType, progress?: number) => void) | 回调入参为当前退场动画的归一化进度[0 - 1]。<br/>- type：跳转方法。<br/>- progress：当前进度。<br/>触发该事件的条件：<br/>逐帧回调，直到退场动画结束，progress从0变化到1。 | 51 52 53## 示例 54 55自定义方式1：配置了当前页面的入场动画为淡入，退场动画为缩小。 56 57```ts 58// index.ets 59@Entry 60@Component 61struct PageTransitionExample1 { 62 @State scale1: number = 1 63 @State opacity1: number = 1 64 65 build() { 66 Column() { 67 Navigator({ target: 'pages/page1', type: NavigationType.Push }) { 68 Image($r('app.media.bg1')).width('100%').height('100%') // 图片存放在media文件夹下 69 } 70 }.scale({ x: this.scale1 }).opacity(this.opacity1) 71 } 72 // 自定义方式1：完全自定义转场过程的效果 73 pageTransition() { 74 PageTransitionEnter({ duration: 1200, curve: Curve.Linear }) 75 .onEnter((type?: RouteType, progress?: number) => { 76 this.scale1 = 1 77 this.opacity1 = progress as number 78 }) // 进场过程中会逐帧触发onEnter回调，入参为动效的归一化进度(0% -- 100%) 79 PageTransitionExit({ duration: 1200, curve: Curve.Ease }) 80 .onExit((type?: RouteType, progress?: number) => { 81 this.scale1 = 1 - (progress as number) 82 this.opacity1 = 1 83 }) // 退场过程中会逐帧触发onExit回调，入参为动效的归一化进度(0% -- 100%) 84 } 85} 86``` 87 88```ts 89// page1.ets 90@Entry 91@Component 92struct AExample { 93 @State scale2: number = 1 94 @State opacity2: number = 1 95 96 build() { 97 Column() { 98 Navigator({ target: 'pages/index', type: NavigationType.Push }) { 99 Image($r('app.media.bg2')).width('100%').height('100%') // 图片存放在media文件夹下 100 } 101 }.width('100%').height('100%').scale({ x: this.scale2 }).opacity(this.opacity2) 102 } 103 // 自定义方式1：完全自定义转场过程的效果 104 pageTransition() { 105 PageTransitionEnter({ duration: 1200, curve: Curve.Linear }) 106 .onEnter((type?: RouteType, progress?: number) => { 107 this.scale2 = 1 108 this.opacity2 = progress as number 109 }) // 进场过程中会逐帧触发onEnter回调，入参为动效的归一化进度(0% -- 100%) 110 PageTransitionExit({ duration: 1200, curve: Curve.Ease }) 111 .onExit((type?: RouteType, progress?: number) => { 112 this.scale2 = 1 - (progress as number) 113 this.opacity2 = 1 114 }) // 退场过程中会逐帧触发onExit回调，入参为动效的归一化进度(0% -- 100%) 115 } 116} 117``` 118 119 120 121自定义方式2：配置了当前页面的入场动画为从左侧滑入，退场为平移加透明度变化。 122 123```ts 124// index.ets 125@Entry 126@Component 127struct PageTransitionExample { 128 build() { 129 Column() { 130 Navigator({ target: 'pages/page1', type: NavigationType.Push }) { 131 Image($r('app.media.bg1')).width('100%').height('100%') // 图片存放在media文件夹下 132 } 133 } 134 } 135 136 // 自定义方式2：使用系统提供的多种默认效果(平移、缩放、透明度等) 137 pageTransition() { 138 // 该页面进入动画时长为1200ms，尽量与另一页面的退出动画时长匹配 139 PageTransitionEnter({ duration: 1200 }) 140 .slide(SlideEffect.Left) 141 // 该页面退出动画时长为1000ms，尽量与另一页面的进入动画时长匹配 142 PageTransitionExit({ duration: 1000 }) 143 .translate({ x: 100.0, y: 100.0 }) 144 .opacity(0) 145 } 146} 147``` 148 149```ts 150// page1.ets 151@Entry 152@Component 153struct PageTransitionExample1 { 154 build() { 155 Column() { 156 Navigator({ target: 'pages/index', type: NavigationType.Push }) { 157 Image($r('app.media.bg2')).width('100%').height('100%') // 图片存放在media文件夹下 158 } 159 } 160 } 161 162 // 自定义方式2：使用系统提供的多种默认效果(平移、缩放、透明度等) 163 pageTransition() { 164 // 该页面进入动画时长为1000ms，尽量与另一页面的退出动画时长匹配 165 PageTransitionEnter({ duration: 1000 }) 166 .slide(SlideEffect.Left) 167 // 该页面退出动画时长为1200ms，尽量与另一页面的进入动画时长匹配 168 PageTransitionExit({ duration: 1200 }) 169 .translate({ x: 100.0, y: 100.0 }) 170 .opacity(0) 171 } 172} 173``` 174 175 176
