当采用Navigation导航时,软件切换后台再切换回前台或手机黑屏重新打开后,会触发子页面的aboutToAppear()事件。
@Entry
@Component
struct Index {
pageStacks: NavPathStack = new NavPathStack();
onPageShow(): void {
setTimeout(() => {
this.pageStacks.replacePathByName('MainPage', null);
}, 2000);
}
build() {
Navigation(this.pageStacks) {
Column() {
Text('我是启动页面!')
.fontSize(30);
}
.height('100%')
.width('100%')
.justifyContent(FlexAlign.Center);
}
.hideToolBar(true)
.hideBackButton(true);
}
} @Builder
export function MainPageBuilder() {
MainPage();
}
@Component
export struct MainPage {
@Provide pageStacks: NavPathStack = new NavPathStack();
@State message: string = 'Hello World!';
aboutToAppear(): void {
setTimeout(() => {
this.message = '触发了aboutToAppear事件!';
}, 2000);
}
build() {
NavDestination() {
Column() {
Text(this.message)
.fontSize(30)
.fontColor(Color.Black);
}
.height('100%')
.width('100%')
.justifyContent(FlexAlign.Center);
}
.hideTitleBar(true)
.onReady((context: NavDestinationContext) => {
this.pageStacks = context.pathStack;
});
}
} 问题效果预览:

Navigation导航:官方推荐的路由导航方式,支持更丰富的动效、一次开发多端部署能力和更灵活的栈操作。在进行路由导航时需要与NavDestination搭配使用。其中Navigation作为page页面的根容器,NavDestination子页面为Navigation的内容展示区。
生命周期差异:
onPageShow(): void {
setTimeout(() => {
this.pageStacks.replacePathByName('MainPage', null);
}, 2000);
console.info('执行了根页面的onPageShow事件!');
} 对应用进行隐藏/显示操作,并查看打印日志:
11-18 17:20:31.949 32047-32047 A00000/testTag com.examp...58799701 I Succeeded in loading the content. 11-18 17:20:31.978 32047-32047 A03d00/JSAPP com.examp...58799701 I 执行了根页面的onPageShow事件! 11-18 17:20:45.403 32047-32047 A00000/testTag com.examp...58799701 I Ability onBackground 11-18 17:20:50.603 32047-32047 A03d00/JSAPP com.examp...58799701 I 执行了根页面的onPageShow事件! 11-18 17:20:50.614 32047-32047 A00000/testTag com.examp...58799701 I Ability onForeground
发现在子页面作为最顶层显示时,此时对整个应用的隐藏与显示,会触发根页面的onPageShow()事件,从而导致黑屏后重新显示、前后台切换等操作会执行子页面重建入栈的操作。
由于Navigation路由的底层逻辑为:NavDestination子页面实际是Navigation根页面的展示区域,是父子组件关系(本质是在一个页面内)。这种独特的导航方式导致,当NavDestination子页面显示在最上层时,前后台切换,看似只会触发该NavDestination子页面的显隐事件,实际也会触发Navigation所在的根页面的显隐事件。
由于应用的显隐操作并不会触发aboutToAppear(),所以将Navigation根页面的onPageShow()事件更换为aboutToAppear()事件,核心修改如下:
aboutToAppear(): void {
setTimeout(() => {
this.pageStacks.replacePathByName('MainPage', null);
}, 2000);
} 完整示例参考如下:
@Entry
@Component
struct Index {
pageStacks: NavPathStack = new NavPathStack();
aboutToAppear(): void {
setTimeout(() => {
this.pageStacks.replacePathByName('MainPage', null);
}, 2000);
}
build() {
Navigation(this.pageStacks) {
Column() {
Text('我是启动页面!')
.fontSize(30)
}
.height('100%')
.width('100%')
.justifyContent(FlexAlign.Center)
}
.hideToolBar(true)
.hideBackButton(true)
}
} @Builder
export function MainPageBuilder() {
MainPage();
}
@Component
export struct MainPage {
@Provide pageStacks: NavPathStack = new NavPathStack();
@State message: string = 'Hello World!';
aboutToAppear(): void {
setTimeout(() => {
this.message = '触发了aboutToAppear事件!';
}, 2000);
}
build() {
NavDestination() {
Column() {
Text(this.message)
.fontSize(30)
.fontColor(Color.Black)
}
.height('100%')
.width('100%')
.justifyContent(FlexAlign.Center)
}
.hideTitleBar(true)
.onReady((context: NavDestinationContext) => {
this.pageStacks = context.pathStack;
})
}
} Q:为什么每次页面切到后台,再切到前台,都会刷新页面?
A:请排查刷新的页面是属于Navigation路由或者是router路由:
Q:Navigation导航时如何监听根页面的显隐事件?
A:由于Navigation页面和NavDestination所在的页面实际是父子组件的关系,导致NavDestination子页切换到Navigation页面时并不会触发Navigation页面的onPageShow事件。Navigation作为根页面,若需监听其显示与隐藏状态,可通过监听Navigation组件的onNavBarStateChange()事件,并在回调函数中判断页面的显示或隐藏状态。