在应用开发中使用Navigation组件时,常遇到与单栏与分栏模式相关的显示需求或异常:
问题一:Navigation组件在宽屏设备(如平板、折叠屏)默认显示双栏,在普通手机竖屏默认显示单栏,开发者希望实现页面在单栏与分栏模式间动态切换显示。
问题二:应用在普通手机设备横屏显示时,发现页面内容仅占据屏幕左侧部分,右侧未铺满(呈现分栏样式);而在竖屏时可以占据整个屏幕,如何修正此布局问题?
若应用需要在不同宽屏设备或用户交互中动态改变单栏与分栏效果,可以通过全局状态管理变量来控制 Navigation 组件的 mode 属性。
@Entry
@Component
struct MainPage {
pageInfos: NavPathStack = new NavPathStack();
@StorageLink('isSplit') isSplit: boolean = true;
// 跳转回主页时重新修改为分栏模式,根据实际需求设置
aboutToAppear(): void {
AppStorage.set('isSplit', true);
}
build() {
Navigation(this.pageInfos) {
Column() {
Button('跳转')
.backgroundColor('#0a59f7')
.width('150')
.height('60')
.onClick(() => {
this.pageInfos.pushPath({ name: 'NavPageOne' });
})
}
}
.mode(this.isSplit ? NavigationMode.Split : NavigationMode.Stack)
.hideTitleBar(true)
.hideToolBar(true)
}
} @Builder
export function NavPageOneBuilder() {
NavPageOne();
}
@Component
struct NavPageOne {
@State message: string = '放大';
// 跳转回该页面时重新修改为分栏模式,根据实际需求设置
aboutToAppear(): void {
AppStorage.set('isSplit', true);
}
build() {
NavDestination() {
RelativeContainer() {
Text(this.message)
.onClick(() => {
let value = AppStorage.get<boolean>('isSplit');
if (value === false || value === undefined) {
AppStorage.set('isSplit', true);
this.message = '放大';
} else {
AppStorage.set('isSplit', false);
this.message = '缩小';
}
})
.width(50)
.textAlign(TextAlign.Center)
}
.height('100%')
.width('100%')
}
.hideTitleBar(true)
}
} 实现效果如下:

在推送子页时修改 Navigation 模式,需要单栏显示的页面设置为 false,需要分栏显示的页面设置为 true。参考场景一,修改代码如下:
@Builder
export function NavPageTwoBuilder() {
NavPageTwo();
}
@Component
struct NavPageTwo {
@State message: string = '缩小';
// Startsolution1
// 其它页面跳转该页面时,会先重置为单栏模式
aboutToAppear(): void {
AppStorage.set('isSplit', false);
this.message = '缩小';
}
// Endsolution1
build() {
NavDestination() {
RelativeContainer() {
Text(this.message)
.onClick(() => {
let value = AppStorage.get<boolean>('isSplit');
if (value === false || value === undefined) {
AppStorage.set('isSplit', true);
this.message = '放大';
} else {
AppStorage.set('isSplit', false);
this.message = '缩小';
}
})
.width(50)
.textAlign(TextAlign.Center);
}
.height('100%')
.width('100%');
}
.hideTitleBar(true);
}
} 注意:以上方案未配置路由表,路由表配置相关官网:系统路由表配置。在工程resources/base/profile中创建route_map.json文件,并在跳转目标模块的配置文件module.json5添加该路由表。route_map.json配置信息如下:
{
"routerMap": [
{
"name": "NavPageTwo",
"pageSourceFile": "src/main/ets/pages/NavPageTwo.ets",
"buildFunction": "NavPageTwoBuilder"
}
,{
"name": "NavPageOne",
"pageSourceFile": "src/main/ets/pages/NavPageOne.ets",
"buildFunction": "NavPageOneBuilder"
}
]
} 问题原因:该现象是由 Navigation 组件的默认分栏模式引起的。Navigation 组件的 mode 属性默认值为 NavigationMode.Auto。从 API version 10 开始,当 Navigation 组件的宽度 >= 600vp 时,会自动采用 Split 分栏模式显示。普通手机在横屏时,宽度往往会达到或超过 600vp,从而自动触发分栏样式,导致页面内容仅占据屏幕左侧部分;而竖屏时宽度不足,保持单栏模式。
解决方案:若应用希望在普通手机设备横屏时依然保持单栏全屏显示,可以将 Navigation 组件的 mode 属性强制指定为 NavigationMode.Stack。
@Entry
@Component
struct MainPage {
pageInfos: NavPathStack = new NavPathStack();
build() {
Navigation(this.pageInfos) {
Column() {
Button('跳转')
.backgroundColor('#0a59f7')
.width('150')
.height('60')
.onClick(() => {
this.pageInfos.pushPath({ name: 'NavPageOne' });
})
}
}
.mode(NavigationMode.Stack) // 强制设置为单栏模式,避免横屏时自动切换为分栏模式
.hideTitleBar(true)
.hideToolBar(true)
}
} 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模式,其组件更新机制是局部刷新(状态管理数据驱动更新),只有受影响的部分会重新渲染。