设置NavDestination生命周期时,可能会遇到以下问题:
场景一:NavDestination生命周期不执行。
场景二:为什么NavDestinationMode.DIALOG模式不触发onHidden和onShown回调。
场景三:申请权限的弹窗为什么能触发NavDestination的onHidden和onShown?
NavDestination是Navigation容器的子组件,不是独立页面,整个Navigation对应1个@Entry页面,内部跳转仅切换NavDestination组件,页面栈未发生改变,故不触发onPageHide和onPageShow。若需要监听其显示和隐藏,可以使用其自有事件onShown和onHidden。
NavDestination组件必须配合Navigation使用,作为Navigation目的页面的根节点,单独使用只能作为普通容器组件,不具备路由相关属性能力。Navigation和NavDestination的配合使用可参考Navigation页面路由的示例。
DIALOG模式进出路由栈不影响下层NavDestination的可见性(onShown、onHidden等生命周期)。
从API17开始,NavDestination新增了onActive和onInactive回调,用于感知NavDestination的激活态和非激活态。
.onActive(() => {
promptAction.openToast({ message: 'onActive触发了' });
})
.onInactive(() => {
promptAction.openToast({ message: 'onInactive触发了' });
}); 当页面切换时,会触发监听NavDestination组件的状态变化,并返回组件信息NavDestinationInfo。通过NavDestinationInfo的name和state可以监听指定NavDestination组件的状态。
aboutToAppear(): void {
uiObserver.on('navDestinationUpdate', (info: NavDestinationInfo) => {
if (info.name === 'NavPage') {
console.info(`Succeeded in getting state.state:${info.state}.`);
}
});
}
aboutToDisappear(): void {
uiObserver.off('navDestinationUpdate');
} 完整示例参考如下:
import { promptAction, uiObserver } from '@kit.ArkUI';
@Entry
@Component
struct DialogPage {
@Provide('pageInfo') pageInfo: NavPathStack = new NavPathStack();
@Builder
pageMap(name: string) {
if (name === 'NavPage') {
NavPage();
} else if (name === 'DialogNav') {
DialogNav();
}
}
aboutToAppear(): void {
uiObserver.on('navDestinationUpdate', (info: NavDestinationInfo) => {
if (info.name === 'NavPage') {
console.info(`Succeeded in getting state.state:${info.state}.`);
}
});
}
aboutToDisappear(): void {
uiObserver.off('navDestinationUpdate');
}
build() {
Navigation(this.pageInfo) {
Button('跳转到Dialog')
.onClick(() => {
this.pageInfo.pushPathByName('DialogNav', null, false);
});
}
.height('100%')
.width('100%')
.navDestination(this.pageMap)
.hideNavBar(true)
.hideTitleBar(true)
.onAppear(() => {
this.pageInfo.pushPathByName('NavPage', null, false);
});
}
}
@Component
struct NavPage {
@Consume('pageInfo') pageInfo: NavPathStack;
build() {
NavDestination() {
Button('跳转到Dialog')
.onClick(() => {
this.pageInfo.pushPathByName('DialogNav', null, false);
});
}
.height('100%')
.width('100%')
.onActive(() => {
promptAction.openToast({ message: 'onActive触发了' });
})
.onInactive(() => {
promptAction.openToast({ message: 'onInactive触发了' });
});
}
}
@Component
struct DialogNav {
@Consume('pageInfo') pageInfo: NavPathStack;
build() {
NavDestination() {
Column() {
Text('DIALOG');
}
.width('80%')
.height(100)
.backgroundColor('#f1f3f5')
.borderRadius(15);
}
.mode(NavDestinationMode.DIALOG);
}
} 效果预览:

权限弹窗属于全局模态组件,会强制覆盖当前页面。当弹窗显示时,当前NavDestination页面会触发onHidden(页面被遮挡)和onInactive(失去焦点)。弹窗关闭后,页面重新可见并激活,触发onShown和onActive回调。
onWillShow仅在页面即将通过路由操作进入前台时触发。权限弹窗的显示/隐藏不涉及路由栈的变化(页面未离开导航栈),因此不会触发路由相关的生命周期onWillShow回调。
import { abilityAccessCtrl, common, Context, bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { PermissionRequestResult, Permissions } from '@ohos.abilityAccessCtrl';
import { promptAction } from '@kit.ArkUI';
@Entry
@Component
struct PermissionPage {
@Provide('pageInfo') pageInfo: NavPathStack = new NavPathStack();
@Builder
pageMap(name: string) {
if (name === 'Page') {
Page();
}
}
build() {
Navigation(this.pageInfo) {
Button('跳转到NavDestination')
.onClick(() => {
this.pageInfo.pushPathByName('Page', null, false);
});
}
.width('100%')
.height('100%')
.navDestination(this.pageMap);
}
}
@Component
struct Page {
@Consume('pageInfo') pageInfo: NavPathStack;
// 检查权限
async checkPermissionGrant(permission: Permissions): Promise<abilityAccessCtrl.GrantStatus> {
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;
// 获取应用程序的accessTokenID。
let tokenId: number = 0;
try {
let bundleInfo: bundleManager.BundleInfo =
await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
tokenId = appInfo.accessTokenId;
} catch (error) {
const err: BusinessError = error as BusinessError;
console.error(`Failed to get bundle info for self, code: ${err.code}, message: ${err.message}`);
}
// 校验应用是否被授予权限。
try {
grantStatus = await atManager.checkAccessToken(tokenId, permission);
} catch (error) {
const err: BusinessError = error as BusinessError;
console.error(`Failed to check access token, code: ${err.code}, message: ${err.message}`);
}
return grantStatus;
}
// 检查位置定位权限,若未授权则开启二次授权
async checkPermissions(): Promise<void> {
// 获取精确定位权限状态。
let grantStatus1: boolean =
await this.checkPermissionGrant('ohos.permission.LOCATION') === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;
// 获取模糊定位权限状态。
let grantStatus2: boolean = await this.checkPermissionGrant('ohos.permission.APPROXIMATELY_LOCATION') ===
abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;
// 精确定位、模糊定位均授权
if (grantStatus1 && grantStatus2) {
promptAction.openToast({ message: '用户已授权' });
} else {
// 进行二次授权
await this.requestPermissionSecond();
}
}
// 申请权限
async requestPermission(): Promise<void> {
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
atManager.requestPermissionsFromUser(context,
['ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION'],
(err: BusinessError, result: PermissionRequestResult) => {
if (err) {
promptAction.openToast({ message: '请求失败' });
} else {
let isGrant = result.authResults.every((status) => {
return status === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;
});
if (isGrant) {
promptAction.openToast({ message: '用户已授权' });
} else {
promptAction.openToast({ message: '用户拒绝授权' });
}
}
});
}
// 二次授权
async requestPermissionSecond(): Promise<void> {
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestPermissionOnSetting(context,
['ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION'])
.then((data: abilityAccessCtrl.GrantStatus[]) => {
console.info(`Succeeded in requestPermissionOnSetting, result: ${data}`);
})
.catch((err: BusinessError) => {
console.error(`Failed to requestPermissionOnSetting, code: ${err.code}, message: ${err.message}`);
});
}
build() {
NavDestination() {
Column({ space: 16 }) {
Button('申请权限')
.onClick(async () => {
await this.requestPermission();
});
Button('二次申请')
.onClick(async () => {
await this.checkPermissions();
});
};
}
.onShown(() => {
console.info(`Succeeded in triggering onShown.`);
})
.onHidden(() => {
console.info(`Succeeded in triggering onHidden.`);
})
.onActive(() => {
console.info(`Succeeded in triggering onActive.`);
})
.onInactive(() => {
console.info(`Succeeded in triggering onInactive.`);
})
.onWillShow(() => {
console.info(`Succeeded in triggering onWillShow. `);
})
.onWillHide(() => {
console.info(`Succeeded in triggering onWillHide. `);
});
}
} 在module.json5中声明所需权限:
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
},
{
"name": "ohos.permission.APPROXIMATELY_LOCATION",
"reason": "$string:approximately_location",
"usedScene": {
"abilities": [
"EntryAbility"
],
"when": "inuse"
}
},
{
"name": "ohos.permission.LOCATION",
"reason": "$string:location",
"usedScene": {
"abilities": [
"EntryAbility"
],
"when": "inuse"
}
}
], 效果预览:

日志如下所示:
