目录

如何解决Navigation跳转页面白屏问题

问题现象

使用Navigation进行页面跳转或返回时,页面出现白屏现象,该如何解决?

场景一:打开应用并加载Navigation页面时,页面显示白屏。

场景二:执行pop或clear返回操作时,页面显示白屏。

场景三:点击跳转后,目标页面显示白屏。

场景四:在平板的分栏模式下,点击左侧导航区域进行跳转后,右侧页面显示白屏。

场景五:使用预览器调试时,Navigation跳转到子页面,子页面显示白屏。

背景知识

解决方案

场景一和场景二:

排查是否设置了Navigation的hideNavBar属性为true。设置为true时,隐藏Navigation的导航页,包括标题栏、内容区和工具栏。如果此时路由栈中存在NavDestination页面,则直接显示栈顶NavDestination页面,反之显示空白。

有以下两种解决方案可供参考:

场景三和场景四:

排查路由表配置是否正常,可参考系统路由表和自定义路由表。

场景五:

预览器不支持Navigation路由跳转,建议使用模拟器或真机进行调试。

常见FAQ

Q:跳转HAR包页面显示白屏,如何处理?

A:按照上述方案排查,并确认在需要引入三方库的模块的oh-package.json5中设置三方包依赖。参考引用及管理共享包。