!23089 文档描述优化

Merge pull request !23089 from LiAn/monthly_20230815

zh-cn/application-dev/quick-start/arkts-page-custom-components-lifecycle.md

@@ -178,7 +178,7 @@ struct Child {
 
 - 点击“push to next page”，调用router.pushUrl接口，跳转到另外一个页面，当前Index页面隐藏，执行页面生命周期Index onPageHide。此处调用的是router.pushUrl接口，Index页面被隐藏，并没有销毁，所以只调用onPageHide。跳转到新页面后，执行初始化新页面的生命周期的流程。
 
-- 如果调用的是router.replaceUrl，则当前Index页面被销毁，执行的生命周期流程将变为：Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。上文已经提到，组件的销毁是从组件树上直接摘下子树，所以先调用父组件的aboutToDisappear，再调用子组件的aboutToDisAppear，然后执行初始化新页面的生命周期流程。
+- 如果调用的是router.replaceUrl，则当前Index页面被销毁，执行的生命周期流程将变为：Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。上文已经提到，组件的销毁是从组件树上直接摘下子树，所以先调用父组件的aboutToDisappear，再调用子组件的aboutToDisappear，然后执行初始化新页面的生命周期流程。
 
 - 点击返回按钮，触发页面生命周期Index onBackPress，且触发返回一个页面后会导致当前Index页面被销毁。
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-marquee.md

 # Marquee
 
-跑马灯组件，用于滚动展示一段单行文本，仅当文本内容宽度超过跑马灯组件宽度时滚动。
+跑马灯组件，用于滚动展示一段单行文本。仅当文本内容宽度超过跑马灯组件宽度时滚动，不超过时不滚动。
 
 
 >  **说明：**

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md

@@ -61,7 +61,7 @@ Text(content?: string | Resource)
 ## 示例
 
 ### 示例1
-textAlign，textOverflow，maxLines，lineHeight使用示例。
+
 ```ts
 // xxx.ets
 @Entry
@@ -144,7 +144,7 @@ struct TextExample1 {
 ![textExp1](figures/textExp1.png)
 
 ### 示例2
-decoration，baselineOffset，letterSpacing，textCase使用示例：
+
 ```ts
 @Entry
 @Component
@@ -253,14 +253,13 @@ struct TextExample2 {
 
 ### 示例3
 
-textShadow，heightAdaptivePolicy，TextOverflow.MARQUEE使用示例：
-
 ```ts
 @Entry
 @Component
 struct TextExample {
   build() {
     Column({ space: 8 }) {
+      // 设置文字阴影效果
       Text('textShadow').fontSize(9).fontColor(0xCCCCCC).margin(15).width('90%')
       Text('textShadow')
         .width('80%')
@@ -271,6 +270,7 @@ struct TextExample {
         .textShadow({ radius: 10, color: Color.Black, offsetX: 0, offsetY: 0 })
         .borderWidth(1)
       Divider()
+      // 设置文本自适应高度的方式
       Text('heightAdaptivePolicy').fontSize(9).fontColor(0xCCCCCC).margin(15).width('90%')
       Text('This is the text with the height adaptive policy set')
         .width('80%')
@@ -300,6 +300,7 @@ struct TextExample {
         .textOverflow({ overflow: TextOverflow.Ellipsis })
         .heightAdaptivePolicy(TextHeightAdaptivePolicy.LAYOUT_CONSTRAINT_FIRST)
       Divider()
+      // 设置文本超长时以跑马灯的方式展示
       Text('marquee').fontSize(9).fontColor(0xCCCCCC).margin(15).width('90%')
       Text('This is the text with the text overflow set marquee')
         .width(300)

zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md

@@ -32,7 +32,7 @@ SideBarContainer( type?: SideBarContainerType )
 
 | 名称 | 描述 |
 | -------- | -------- |
-| Embed | 侧边栏嵌入到组件内，和内容区并列显示。 |
+| Embed | 侧边栏嵌入到组件内，和内容区并列显示。当前屏幕尺寸大于600vp时，该枚举值生效。小于600vp时，侧边栏会自动隐藏。在自动隐藏后，如果通过点击控制按钮唤出侧边栏，则侧边栏默认通过Overlay方式显示。|
 | Overlay | 侧边栏浮在内容区上面。 |
 | AUTO | 组件尺寸大于等于minSideBarWidth+minContentWidth时，采用Embed模式显示。<br/>组件尺寸小于minSideBarWidth+minContentWidth时，采用Overlay模式显示。<br/>未设置minSideBarWidth或minContentWidth时，会使用未设置接口的默认值进行计算，若计算的值小于600vp，则使用600vp做为模式切换的断点值。|
 

zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md

 # 页面间转场
 
-当路由进行切换时，可以通过 在pageTransition函数中自定义页面入场和页面退场的转场动效。
+当路由进行切换时，可以通过在pageTransition函数中自定义页面入场和页面退场的转场动效。详细指导请参考[页面转场动画](../../ui/arkts-page-transition-animation.md)。
 
 > **说明：**
 >
@@ -11,8 +11,8 @@
 
 | 名称                | 参数                                                         | 必填 | 参数描述                                                     |
 | ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| PageTransitionEnter | {<br/>type?: RouteType,<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve)&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br>delay?: number<br/>} | 否   | 设置当前页面的自定义入场动效。<br/>-&nbsp;type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>-&nbsp;duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>-&nbsp;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/>-&nbsp;delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 |
-| PageTransitionExit  | {<br/>type?: RouteType,<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve)&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br/>delay?: number<br/>} | 否   | 设置当前页面的自定义退场动效。<br/>-&nbsp;type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>-&nbsp;duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>-&nbsp;curve：动画曲线，string类型取值与PageTransitionEnter相同。<br/>&nbsp;默认值：Curve.Linear<br/>-&nbsp;delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 |
+| PageTransitionEnter | {<br/>type?: [RouteType](#routetype枚举说明)e,<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve)&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br>delay?: number<br/>} | 否   | 设置当前页面的自定义入场动效。<br/>-&nbsp;type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>-&nbsp;duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>-&nbsp;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/>-&nbsp;delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 |
+| PageTransitionExit  | {<br/>type?: [RouteType](#routetype枚举说明),<br/>duration?: number,<br/>curve?: [Curve](ts-appendix-enums.md#curve)&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[ICurve](../apis/js-apis-curve.md#icurve)<sup>10+</sup>,<br/>delay?: number<br/>} | 否   | 设置当前页面的自定义退场动效。<br/>-&nbsp;type：页面转场效果生效的路由类型。<br/>默认值：RouteType.None。<br/>-&nbsp;duration：动画的时长。<br/>单位：毫秒<br/>默认值：1000<br/>-&nbsp;curve：动画曲线，string类型取值与PageTransitionEnter相同。<br/>&nbsp;默认值：Curve.Linear<br/>-&nbsp;delay：动画延迟时长。<br/>单位：毫秒<br/>默认值：0<br/>**说明：** <br/>没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异)，如需禁用系统默认页面转场效果，可以指定duration为0。 |
 
 ## RouteType枚举说明
 

zh-cn/application-dev/ui/Readme-CN.md

@@ -51,6 +51,7 @@
       - [导航转场](arkts-navigation-transition.md)
       - [模态转场](arkts-modal-transition.md)
       - [共享元素转场](arkts-shared-element-transition.md)
+      - [页面转场动画（不推荐）](arkts-page-transition-animation.md)
     - [组件动画](arkts-component-animation.md)
     - 动画曲线
       - [动画曲线概述](arkts-curve-overview.md)

zh-cn/application-dev/ui/arkts-navigation-transition.md

@@ -4,7 +4,7 @@
 导航转场是页面的路由转场方式，也就是一个界面消失，另外一个界面出现的动画效果。导航转场的动画效果是系统定义的，开发者不能修改。
 
 
-导航转场推荐使用[Navigation](../reference/arkui-ts/ts-basic-components-navigation.md)组件实现，可搭配[NavRouter](../reference/arkui-ts/ts-basic-components-navrouter.md)组件和[NavDestination](../reference/arkui-ts/ts-basic-components-navdestination.md)组件实现导航功能。
+导航转场推荐使用[Navigation](arkts-navigation-navigation.md)组件实现，可搭配[NavRouter](../reference/arkui-ts/ts-basic-components-navrouter.md)组件和[NavDestination](../reference/arkui-ts/ts-basic-components-navdestination.md)组件实现导航功能。
 
 
 完整的代码示例和效果如下。

zh-cn/application-dev/ui/arkts-page-transition-animation.md

+# 页面转场动画（不推荐）
+
+为了实现更好的转场效果，推荐使用[导航转场](arkts-navigation-transition.md)和[模态转场](arkts-modal-transition.md)。
+
+
+两个页面间发生跳转，一个页面消失，另一个页面出现，这时可以配置各自页面的页面转场参数实现自定义的页面转场效果。[页面转场](../reference/arkui-ts/ts-page-transition-animation.md)效果写在pageTransition函数中，通过PageTransitionEnter和PageTransitionExit指定页面进入和退出的动画效果。
+
+
+PageTransitionEnter的接口为：
+
+
+
+```ts
+PageTransitionEnter({type?: RouteType,duration?: number,curve?: Curve | string,delay?: number})
+```
+
+
+PageTransitionExit的接口为：
+
+
+
+```ts
+PageTransitionExit({type?: RouteType,duration?: number,curve?: Curve | string,delay?: number})
+```
+
+
+上述接口定义了PageTransitionEnter和PageTransitionExit组件，可通过slide、translate、scale、opacity属性定义不同的页面转场效果。对于PageTransitionEnter而言，这些效果表示入场时起点值，对于PageTransitionExit而言，这些效果表示退场的终点值，这一点与组件转场transition配置方法类似。此外，PageTransitionEnter提供了onEnter接口进行自定义页面入场动画的回调，PageTransitionExit提供了onExit接口进行自定义页面退场动画的回调。
+
+
+上述接口中的参数type，表示路由生效的类型，这一点开发者容易混淆其含义。页面转场的两个页面，必定有一个页面退出，一个页面进入。如果通过router.pushUrl操作从页面A跳转到页面B，则页面A退出，做页面退场动画，页面B进入，做页面入场动画。如果通过router.back操作从页面B返回到页面A，则页面B退出，做页面退场动画，页面A进入，做页面入场动画。即页面的PageTransitionEnter既可能是由于新增页面(push，入栈)引起的新页面的入场动画，也可能是由于页面返回(back，或pop，出栈)引起的页面栈中老页面的入场动画，为了能区分这两种形式的入场动画，提供了type参数，这样开发者能完全定义所有类型的页面转场效果。
+
+
+## type配置为RouteType.None
+
+type为RouteType.None表示对页面栈的push、pop操作均生效，type的默认值为RouteType.None。
+
+
+```ts
+// page A
+pageTransition() {
+  // 定义页面进入时的效果，从左侧滑入，时长为1200ms，无论页面栈发生push还是pop操作均可生效
+  PageTransitionEnter({ type: RouteType.None, duration: 1200 })
+    .slide(SlideEffect.Left)
+  // 定义页面退出时的效果，向左侧滑出，时长为1000ms，无论页面栈发生push还是pop操作均可生效
+  PageTransitionExit({ type: RouteType.None, duration: 1000 })
+    .slide(SlideEffect.Left)
+}
+```
+
+
+
+```ts
+// page B
+pageTransition() {
+  // 定义页面进入时的效果，从右侧滑入，时长为1000ms，无论页面栈发生push还是pop操作均可生效
+  PageTransitionEnter({ type: RouteType.None, duration: 1000 })
+    .slide(SlideEffect.Right)
+  // 定义页面退出时的效果，向右侧滑出，时长为1200ms，无论页面栈发生push还是pop操作均可生效
+  PageTransitionExit({ type: RouteType.None, duration: 1200 })
+    .slide(SlideEffect.Right)
+}
+```
+
+
+假设页面跳转配置为多实例模式，即页面栈中允许存在重复的页面。可能会有4种场景，对应的页面转场效果如下表。
+
+
+| 路由操作                         | 页面A转场效果                            | 页面B转场效果                            |
+| ---------------------------- | ---------------------------------- | ---------------------------------- |
+| router.pushUrl，从页面A跳转到新增的页面B | 页面退出，PageTransitionExit生效，向左侧滑出屏幕  | 页面进入，PageTransitionEnter生效，从右侧滑入屏幕 |
+| router.back，从页面B返回到页面A       | 页面进入，PageTransitionEnter生效，从左侧滑入屏幕 | 页面退出，PageTransitionExit生效，向右侧滑出屏幕  |
+| router.pushUrl，从页面B跳转到新增的页面A | 页面进入，PageTransitionEnter生效，从左侧滑入屏幕 | 页面退出，PageTransitionExit生效，向右侧滑出屏幕  |
+| router.back，从页面A返回到页面B       | 页面退出，PageTransitionExit生效，向左侧滑出屏幕  | 页面进入，PageTransitionEnter生效，从右侧滑入屏幕 |
+
+
+如果希望pushUrl进入的页面总是从右侧滑入，back时退出的页面总是从右侧滑出，则上表中的第3、4种情况不满足要求，那么需要完整的定义4个页面转场效果。
+
+
+## type配置为RouteType.Push或RouteType.Pop
+
+type为RouteType.Push表示仅对页面栈的push操作生效，type为RouteType.Pop表示仅对页面栈的pop操作生效。
+
+
+```ts
+// page A
+pageTransition() {
+  // 定义页面进入时的效果，从右侧滑入，时长为1200ms，页面栈发生push操作时该效果才生效
+  PageTransitionEnter({ type: RouteType.Push, duration: 1200 })
+    .slide(SlideEffect.Right)
+  // 定义页面进入时的效果，从左侧滑入，时长为1200ms，页面栈发生pop操作时该效果才生效
+  PageTransitionEnter({ type: RouteType.Pop, duration: 1200 })
+    .slide(SlideEffect.Left)
+  // 定义页面退出时的效果，向左侧滑出，时长为1000ms，页面栈发生push操作时该效果才生效
+  PageTransitionExit({ type: RouteType.Push, duration: 1000 })
+    .slide(SlideEffect.Left)
+  // 定义页面退出时的效果，向右侧滑出，时长为1000ms，页面栈发生pop操作时该效果才生效
+  PageTransitionExit({ type: RouteType.Pop, duration: 1000 })
+    .slide(SlideEffect.Right)
+}
+```
+
+
+
+```ts
+// page B
+pageTransition() {
+  // 定义页面进入时的效果，从右侧滑入，时长为1000ms，页面栈发生push操作时该效果才生效
+  PageTransitionEnter({ type: RouteType.Push, duration: 1000 })
+    .slide(SlideEffect.Right)
+  // 定义页面进入时的效果，从左侧滑入，时长为1000ms，页面栈发生pop操作时该效果才生效
+  PageTransitionEnter({ type: RouteType.Pop, duration: 1000 })
+    .slide(SlideEffect.Left)
+  // 定义页面退出时的效果，向左侧滑出，时长为1200ms，页面栈发生push操作时该效果才生效
+  PageTransitionExit({ type: RouteType.Push, duration: 1200 })
+    .slide(SlideEffect.Left)
+  // 定义页面退出时的效果，向右侧滑出，时长为1200ms，页面栈发生pop操作时该效果才生效
+  PageTransitionExit({ type: RouteType.Pop, duration: 1200 })
+    .slide(SlideEffect.Right)
+}
+```
+
+
+以上代码则完整的定义了所有可能的页面转场样式。假设页面跳转配置为多实例模式，即页面栈中允许存在重复的页面。可能会有4种场景，对应的页面转场效果如下表。
+
+
+| 路由操作                         | 页面A转场效果                                  | 页面B转场效果                                  |
+| ---------------------------- | ---------------------------------------- | ---------------------------------------- |
+| router.pushUrl，从页面A跳转到新增的页面B | 页面退出，PageTransitionExit且type为RouteType.Push的转场样式生效，向左侧滑出屏幕 | 页面进入，PageTransitionEnter且type为RouteType.Push的转场样式生效，从右侧滑入屏幕 |
+| router.back，从页面B返回到页面A       | 页面进入，PageTransitionEnter且type为RouteType.Pop的转场样式生效，从左侧滑入屏幕 | 页面退出，PageTransitionExit且type为RouteType.Pop的转场样式生效，向右侧滑出屏幕 |
+| router.pushUrl，从页面B跳转到新增的页面A | 页面进入，PageTransitionEnter且type为RouteType.Push的转场样式生效，从右侧滑入屏幕 | 页面退出，PageTransitionExit且type为RouteType.Push的转场样式生效，向左侧滑出屏幕 |
+| router.back，从页面A返回到页面B       | 页面退出，PageTransitionExit且type为RouteType.Pop的转场样式生效，向右侧滑出屏幕 | 页面进入，PageTransitionEnter且type为RouteType.Pop的转场样式生效，从左侧滑入屏幕 |
+
+
+>**说明：**
+>
+>    1. 由于每个页面的页面转场样式都可由开发者独立配置，而页面转场涉及到两个页面，开发者应考虑两个页面的页面转场效果的衔接，如时长尽量保持一致。
+>
+>    2. 如果没有定义匹配的页面转场样式，则该页面使用系统默认的页面转场样式。
+
+
+## 禁用某页面的页面转场
+
+
+```ts
+pageTransition() {
+  PageTransitionEnter({ type: RouteType.None, duration: 0 })
+  PageTransitionExit({ type: RouteType.None, duration: 0 })
+}
+```
+
+
+通过设置页面转场的时长为0，可使该页面无页面转场动画。
+
+
+## 场景示例
+
+下面介绍定义了所有的四种页面转场样式的页面转场动画示例。
+
+
+
+```ts
+// PageTransitionSrc1
+import router from '@ohos.router';
+@Entry
+@Component
+struct PageTransitionSrc1 {
+  build() {
+    Column() {
+      Image($r('app.media.mountain'))
+        .width('90%')
+        .height('80%')
+        .objectFit(ImageFit.Fill)
+        .syncLoad(true) // 同步加载图片，使页面出现时图片已经加载完成
+        .margin(30)
+
+      Row({ space: 10 }) {
+        Button("pushUrl")
+          .onClick(() => {
+            // 路由到下一个页面，push操作
+            router.pushUrl({ url: 'pages/myTest/pageTransitionDst1' });
+          })
+        Button("back")
+          .onClick(() => {
+            // 返回到上一页面，相当于pop操作
+            router.back();
+          })
+      }.justifyContent(FlexAlign.Center)
+    }
+    .width("100%").height("100%")
+    .alignItems(HorizontalAlign.Center)
+  }
+
+  pageTransition() {
+    // 定义页面进入时的效果，从右侧滑入，时长为1000ms，页面栈发生push操作时该效果才生效
+    PageTransitionEnter({ type: RouteType.Push, duration: 1000 })
+      .slide(SlideEffect.Right)
+    // 定义页面进入时的效果，从左侧滑入，时长为1000ms，页面栈发生pop操作时该效果才生效
+    PageTransitionEnter({ type: RouteType.Pop, duration: 1000 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，向左侧滑出，时长为1000ms，页面栈发生push操作时该效果才生效
+    PageTransitionExit({ type: RouteType.Push, duration: 1000 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，向右侧滑出，时长为1000ms，页面栈发生pop操作时该效果才生效
+    PageTransitionExit({ type: RouteType.Pop, duration: 1000 })
+      .slide(SlideEffect.Right)
+  }
+}
+```
+
+
+
+
+```ts
+// PageTransitionDst1
+import router from '@ohos.router';
+@Entry
+@Component
+struct PageTransitionDst1 {
+  build() {
+    Column() {
+      Image($r('app.media.forest'))
+        .width('90%')
+        .height('80%')
+        .objectFit(ImageFit.Fill)
+        .syncLoad(true) // 同步加载图片，使页面出现时图片已经加载完成
+        .margin(30)
+
+      Row({ space: 10 }) {
+        Button("pushUrl")
+          .onClick(() => {
+            // 路由到下一页面，push操作
+            router.pushUrl({ url: 'pages/myTest/pageTransitionSrc1' });
+          })
+        Button("back")
+          .onClick(() => {
+            // 返回到上一页面，相当于pop操作
+            router.back();
+          })
+      }.justifyContent(FlexAlign.Center)
+    }
+    .width("100%").height("100%")
+    .alignItems(HorizontalAlign.Center)
+  }
+
+  pageTransition() {
+    // 定义页面进入时的效果，从右侧滑入，时长为1000ms，页面栈发生push操作时该效果才生效
+    PageTransitionEnter({ type: RouteType.Push, duration: 1000 })
+      .slide(SlideEffect.Right)
+    // 定义页面进入时的效果，从左侧滑入，时长为1000ms，页面栈发生pop操作时该效果才生效
+    PageTransitionEnter({ type: RouteType.Pop, duration: 1000 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，向左侧滑出，时长为1000ms，页面栈发生push操作时该效果才生效
+    PageTransitionExit({ type: RouteType.Push, duration: 1000 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，向右侧滑出，时长为1000ms，页面栈发生pop操作时该效果才生效
+    PageTransitionExit({ type: RouteType.Pop, duration: 1000 })
+      .slide(SlideEffect.Right)
+  }
+}
+```
+
+
+
+![pageTransition_PushPop](figures/pageTransition_PushPop.gif)
+
+
+下面介绍使用了type为None的页面转场动画示例。
+
+
+
+```ts
+// PageTransitionSrc2
+import router from '@ohos.router';
+@Entry
+@Component
+struct PageTransitionSrc2 {
+  build() {
+    Column() {
+      Image($r('app.media.mountain'))
+        .width('90%')
+        .height('80%')
+        .objectFit(ImageFit.Fill)
+        .syncLoad(true) // 同步加载图片，使页面出现时图片已经加载完成
+        .margin(30)
+
+      Row({ space: 10 }) {
+        Button("pushUrl")
+          .onClick(() => {
+            // 路由到下一页面，push操作
+            router.pushUrl({ url: 'pages/myTest/pageTransitionDst2' });
+          })
+        Button("back")
+          .onClick(() => {
+            // 返回到上一页面，相当于pop操作
+            router.back();
+          })
+      }.justifyContent(FlexAlign.Center)
+    }
+    .width("100%").height("100%")
+    .alignItems(HorizontalAlign.Center)
+  }
+
+  pageTransition() {
+    // 定义页面进入时的效果，从左侧滑入，时长为1000ms，无论页面栈发生push还是pop操作均可生效
+    PageTransitionEnter({ duration: 1000 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，相对于正常页面位置x方向平移100vp，y方向平移100vp，透明度变为0，时长为1200ms，无论页面栈发生push还是pop操作均可生效
+    PageTransitionExit({ duration: 1200 })
+      .translate({ x: 100.0, y: 100.0 })
+      .opacity(0)
+  }
+}
+```
+
+
+
+```ts
+// PageTransitionDst2
+import router from '@ohos.router';
+@Entry
+@Component
+struct PageTransitionDst2 {
+  build() {
+    Column() {
+      Image($r('app.media.forest'))
+        .width('90%')
+        .height('80%')
+        .objectFit(ImageFit.Fill)
+        .syncLoad(true) // 同步加载图片，使页面出现时图片已经加载完成
+        .margin(30)
+
+      Row({ space: 10 }) {
+        Button("pushUrl")
+          .onClick(() => {
+            // 路由到下一页面，push操作
+            router.pushUrl({ url: 'pages/myTest/pageTransitionSrc2' });
+          })
+        Button("back")
+          .onClick(() => {
+            // 返回到上一页面，相当于pop操作
+            router.back();
+          })
+      }.justifyContent(FlexAlign.Center)
+    }
+    .width("100%").height("100%")
+    .alignItems(HorizontalAlign.Center)
+  }
+
+  pageTransition() {
+    // 定义页面进入时的效果，从左侧滑入，时长为1200ms，无论页面栈发生push还是pop操作均可生效
+    PageTransitionEnter({ duration: 1200 })
+      .slide(SlideEffect.Left)
+    // 定义页面退出时的效果，相对于正常页面位置x方向平移100vp，y方向平移100vp，透明度变为0，时长为1000ms，无论页面栈发生push还是pop操作均可生效
+    PageTransitionExit({ duration: 1000 })
+      .translate({ x: 100.0, y: 100.0 })
+      .opacity(0)
+  }
+}
+```
+
+
+
+![pageTransition_None](figures/pageTransition_None.gif)

zh-cn/application-dev/ui/arkts-transition-overview.md

@@ -15,6 +15,8 @@
 
 - [共享元素转场](arkts-shared-element-transition.md)：共享元素转场是一种界面切换时对相同或者相似的元素做的一种位置和大小匹配的过渡动画效果。
 
+- [页面转场动画（不推荐）](arkts-page-transition-animation.md)：页面的路由转场方式，可以通过在pageTransition函数中自定义页面入场和页面退场的转场动效。为了实现更好的转场效果，推荐使用[导航转场](arkts-navigation-transition.md)和[模态转场](arkts-modal-transition.md)。
+
 ## 相关实例
 
 针对转场动画开发，有以下相关实例可供参考“