使用Navigation进行页面跳转或返回时,页面出现白屏现象,该如何解决?
场景一:打开应用并加载Navigation页面时,页面显示白屏。
场景二:执行pop或clear返回操作时,页面显示白屏。
场景三:点击跳转后,目标页面显示白屏。
场景四:在平板的分栏模式下,点击左侧导航区域进行跳转后,右侧页面显示白屏。
场景五:使用预览器调试时,Navigation跳转到子页面,子页面显示白屏。
场景一和场景二:
排查是否设置了Navigation的hideNavBar属性为true。设置为true时,隐藏Navigation的导航页,包括标题栏、内容区和工具栏。如果此时路由栈中存在NavDestination页面,则直接显示栈顶NavDestination页面,反之显示空白。
有以下两种解决方案可供参考:
@Entry
@Component
struct HideNavBarPage {
pathStack: NavPathStack = new NavPathStack(); // 导航控制器对象
aboutToAppear(): void {
// 进入主页面时直接 push 一个子页面,这个子页面就作为 APP 的主页面
this.pathStack.pushPathByName('NavDesOne', undefined, false); // 注意关闭转场动画效果
// 使用路由拦截功能
this.pathStack.setInterception({
willShow: (from: NavDestinationContext | NavBar, to: NavDestinationContext | NavBar,
operation: NavigationOperation, isAnimated: boolean) => {
console.info(`${from} ${to} ${operation} ${isAnimated}`);
// 如果要返回到主页面,就 push 名为 NavDesOne 的子页面
if (to == 'navBar') {
// 注意关闭转场动画效果,NavDesOne需自行创建并配置
this.pathStack.pushPathByName('NavDesOne', undefined, false);
}
}
});
}
build() {
Navigation(this.pathStack) {
}
.hideNavBar(true) // NavBar页面不显示
.height('100%').width('100%');
}
} 场景三和场景四:
"routerMap": "$profile:route_map",
{
"routerMap": [
{
"name": "NavDesOne",
"pageSourceFile": "src/main/ets/pages/NavDesOne.ets",
"buildFunction": "NavDesBuilder"
}
]
} RouterMapDemo页面代码如下,Entry页面需在resources/base/profile/main_pages.json配置,参考pages标签。
@Entry
@Component
struct RouterMapDemo {
pathStack: NavPathStack = new NavPathStack(); // 导航控制器对象
build() {
// 根节点使用Navigation组件
Navigation(this.pathStack) { // 将导航控制器对象和Navigation绑定
Column({ space: 24 }) {
Text('这是Navigation根页面');
Button('跳转NavDestination子页')
.onClick(() => {
// 通过name(需要和路由表route_map设置的name保持一致)指定子页
this.pathStack.pushPath({ name: 'NavDesOne' }, true);
});
}.width('100%').height('100%');
}
.hideToolBar(true) // 隐藏工具栏
.height('100%').width('100%');
}
} @Builder
export function NavDesBuilder() {
NavDesOne();
}
@Component
struct NavDesOne {
pathStack: NavPathStack = new NavPathStack(); // 导航控制器对象
build() {
NavDestination() {
Column({ space: 24 }) {
Text('Hello World').fontSize(36);
}.width('100%').height('100%').justifyContent(FlexAlign.Center);
}
.onReady((ctx: NavDestinationContext) => {
// 通过NavDestination上下文信息获取到导航控制器对象
// Navigation及其所有子页的pathStack需保证为同一个
this.pathStack = ctx.pathStack;
});
}
} NavDesMapDemo代码如下,Entry页面需在resources/base/profile/main_pages.json配置,参考pages标签。NavDesOne代码见上文系统路由表第3点。
import { NavDesBuilder } from './NavDesOne'; // 静态import导入页面
@Entry
@Component
struct NavDesMapDemo {
pathStack: NavPathStack = new NavPathStack(); // 导航控制器对象
build() {
// 根节点使用Navigation组件
Navigation(this.pathStack) { // 将导航控制器对象和Navigation绑定
Column({ space: 24 }) {
Text('这是Navigation根页面');
Button('跳转NavDestination子页')
.onClick(() => {
// 通过name(需要和自定义路由表设置的name保持一致)指定子页
this.pathStack.pushPath({ name: 'NavDesOne' }, true);
});
};
}
.navDestination(this.pageMap) // 注册路由表
.hideToolBar(true) // 隐藏工具栏
.height('100%').width('100%');
}
// 自定义路由表:根据子页名称寻址
@Builder
pageMap(name: string) {
if (name === 'NavDesOne') {
NavDesBuilder();
}
}
} 场景五:
预览器不支持Navigation路由跳转,建议使用模拟器或真机进行调试。