目录

HarmonyOS中Navigation组件单栏与分栏模式动态切换及横屏布局异常解决方案

问题现象

在应用开发中使用Navigation组件时,常遇到与单栏与分栏模式相关的显示需求或异常:

问题一:Navigation组件在宽屏设备(如平板、折叠屏)默认显示双栏,在普通手机竖屏默认显示单栏,开发者希望实现页面在单栏与分栏模式间动态切换显示。

问题二:应用在普通手机设备横屏显示时,发现页面内容仅占据屏幕左侧部分,右侧未铺满(呈现分栏样式);而在竖屏时可以占据整个屏幕,如何修正此布局问题?

背景知识

解决方案

常见FAQ

Q:navBarWidth和navBarWidthRange属性是否可以实现子页放大的功能?

A:不建议通过navBarWidth和navBarWidthRange实现子页放大功能,该方式存在一定的宽度限制,建议使用上述方案或者分栏模式下设置hideNavBar()为true。

Q:在进行一多适配时,通过display.getDefaultDisplaySync().width获取屏幕宽度然后给UI组件设置宽度,但是分栏模式下由于分栏不是整个屏幕宽度,会导致布局错乱。如何自动获取分栏的宽度?

A:目前没有直接的接口获取分栏的宽度,可以参考链接中NavigationMode为Split时,navBarWidth(左分屏宽度)计算规则实现自动计算分栏宽度。从而进行一多适配分栏模式开发。

Q:Navigation如何禁用分栏模式?

A:Navigation组件默认处于Auto模式,其样式会根据应用窗口尺寸在单栏和双栏之间自动切换,想要禁用双栏模式,将Navigation的mode属性值置为Stack即可,其它更丰富的实现方式可参考官网:实现单双栏的显示效果。

Q:分栏模式下点击导航栏的页面推送导致右侧内容区渲染了多个相同的页面,返回时会多次返回相同的页面,有什么方式可以防止这种现象发生?

A:推送页面时采用单例模式跳转(即跳转时LaunchMode采用MOVE_TO_TOP_SINGLETON或POP_TO_SINGLETON模式)或者设置判定变量判断是否推送过该页面,若是推送过则采用this.pathStack.replacePathByName()方法替换页面,而不是重新推送新页面。

Q:通过状态管理实现动态切换mode属性的单栏与分栏模式,是否会造成性能问题?

A:Navigation的mode属性虽然作用于整个容器,但是mode的改变只会调整容器的布局模式。由于ArkUI的UI开发模式属于MVVM模式,其组件更新机制是局部刷新(状态管理数据驱动更新),只有受影响的部分会重新渲染。