NavDestination是Navigation子页面的根容器,用于承载子页面的特殊属性和生命周期。NavDestination可以配置独立的标题栏、菜单栏与工具栏等属性,使用方法与Navigation一致。NavDestination还支持通过mode属性设置不同的显示模式,以适应不同页面的需求。
NavDestination提供了两种类型。
标准类型:
NavDestination页面默认为标准类型,此时mode属性为NavDestinationMode.STANDARD。Navigation中只能显示一个标准类型的NavDestination页面。
弹窗类型:
NavDestination设置mode为NavDestinationMode.DIALOG弹窗类型,此时整个NavDestination默认透明显示。弹窗类型的NavDestination显示和消失时不会影响下层标准类型的NavDestination的显示和生命周期,两者可以同时显示。
// NavDestination弹窗类型
@Entry
@Component
struct PageDisplayType {
@Provide('NavPathStack') pageStack: NavPathStack = new NavPathStack();
@Builder
PagesMap(name: string) {
if (name == 'DialogPage') {
DialogPage();
}
}
build() {
Navigation(this.pageStack) {
Button('Push DialogPage')
.margin(20)
.width('80%')
.onClick(() => {
this.pageStack.pushPathByName('DialogPage', '');
})
}
.mode(NavigationMode.Stack)
.title('Main')
.navDestination(this.PagesMap)
}
}
@Component
export struct DialogPage {
@Consume('NavPathStack') pageStack: NavPathStack;
build() {
NavDestination() {
Stack({ alignContent: Alignment.Center }) {
Column() {
Text('Dialog NavDestination')
.fontSize(20)
.margin({ bottom: 100 })
Button('Close').onClick(() => {
this.pageStack.pop();
}).width('30%')
}
.justifyContent(FlexAlign.Center)
.backgroundColor(Color.White)
.borderRadius(10)
.height('30%')
.width('80%')
}.height('100%').width('100%')
}
.backgroundColor('rgba(0,0,0,0.5)')
.hideTitleBar(true)
.mode(NavDestinationMode.DIALOG)
}
} 
页面生命周期承载在NavDestination组件上,可分为三类:自定义组件生命周期、通用组件生命周期和NavDestination生命周期事件。其中,aboutToAppear和aboutToDisappear是自定义组件的生命周期(NavDestination外层包含的自定义组件),onAppear和onDisAppear是组件的通用生命周期。剩下的生命周期为NavDestination独有。
生命周期时序如下图所示:

此外还有两个特殊生命周期:
在NavDestination子页面内部的自定义组件可以通过全局方法监听或查询到页面的一些状态信息,从而实现组件与页面解耦。
页面信息查询:
自定义组件提供queryNavDestinationInfo方法,可以在NavDestination内部查询到当前所属页面的信息,返回值为NavDestinationInfo,若查询不到则返回undefined。
import { uiObserver } from '@kit.ArkUI';
// NavDestination内的自定义组件
@Component
struct MyComponent {
navDesInfo: uiObserver.NavDestinationInfo | undefined;
context = this.getUIContext().getHostContext();
aboutToAppear() {
this.navDesInfo = this.queryNavDestinationInfo();
}
build() {
// ...
Column() {
// $r('app.string.onPageName')资源文件中的value值为“所属页面Name:”
Text(this.context!.resourceManager.getStringSync($r('app.string.onPageName').id) + `${this.navDesInfo?.name}`)
}.width('100%').height('100%')
// ...
}
} 页面状态监听:
通过observer.on('navDestinationUpdate')提供的注册接口可以注册NavDestination生命周期变化的监听。
也可以通过observer.on('navDestinationSwitch')注册页面切换的状态回调。该回调能在页面发生路由切换时拿到对应的页面信息NavDestinationSwitchInfo,并提供了UIAbilityContext和UIContext不同范围的监听。