共享元素转场(sharedTransition)用于在页面跳转时实现共享元素位置、大小等的平滑过渡动画,使同一元素在不同页面间保持视觉连续性,提升用户体验和转场流畅度。可以通过设置组件的sharedTransition属性将该元素标记为共享元素并设置对应的共享元素转场动效。sharedTransition仅发生在@ohos.router (页面路由)跳转时。
从API version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
示例代码为点击图片所在区域跳转页面时,显示共享元素图片的自定义转场动效。
// xxx.ets
@Entry
@Component
struct SharedTransitionExample {
build() {
Column() {
// $r('app.media.ic_health_heart')需要替换为开发者所需的图像资源文件。
Image($r('app.media.ic_health_heart')).width(50).height(50).margin({ left: 20, top: 20 })
.sharedTransition('sharedImage', { duration: 800, curve: Curve.Linear, delay: 100 })
}.width('100%').height('100%').alignItems(HorizontalAlign.Start)
.onClick(() => {
this.getUIContext().getRouter().pushUrl({ url: 'pages/PageB' });
})
}
pageTransition() {
PageTransitionEnter({ type: RouteType.None, duration: 0 })
PageTransitionExit({ type: RouteType.None, duration: 0 })
}
} // PageB.ets
@Entry
@Component
struct PageBExample {
build() {
Stack() {
// $r('app.media.ic_health_heart')需要替换为开发者所需的图像资源文件。
Image($r('app.media.ic_health_heart')).width(150).height(150)
.sharedTransition('sharedImage', { duration: 800, curve: Curve.Linear, delay: 100 })
}.width('100%').height('100%')
}
pageTransition() {
PageTransitionEnter({ type: RouteType.None, duration: 0 })
PageTransitionExit({ type: RouteType.None, duration: 0 })
}
} 