1.3.2 导航之 NavigationSplitView
NavigationSplitView 用于快速构建多栏视图,它支持在 Apple 全平台上使用。根据设备屏幕尺寸(Size Class)的差异,NavigationSplitView 的样式有所不同。
Size Class 分为 regular 和 compact,NavigationSplitView 相应的表现分别是分栏和导航栈。正如示例所示,在 iPhone 14 Plus 或 iPhone 14 Pro Max 机型上,竖屏时 Size Class 是 compact,导航行为就是常见的 push 和 pop。而横屏时,Size Class 是 regular,视图会变成分栏样式。
> 查看示例
关于 iOS 设备的尺寸信息,可以查看 Device size classes。
相比 NavigationStack,NavigationSplitView 的使用相对简单。它包含如下初始化方法:
|
|
sidebar 和 detail 分别对应第一栏和最后一栏,content 是中间一栏。后一栏的数据依赖于前一栏的选择,sidebar 和 content 通常使用 List 来构建视图,因为它可以很方便地获取到当前选中的条目。需要注意的是,List 有许多的初始化方法,各个方法之间有非常细微的差别,支持的平台也不尽相同,所以使用时需要小心一些,遇到疑问时及时查看文档。
如果需要控制分栏视图的可见性,可以绑定参数至 columnVisibility。NavigationSplitViewVisibility 有如下样式:
- automatic:根据设备自适应。
- all:显示所有分栏。
- doubleColumn:双栏都显示,三栏显示后面两栏。
- detailOnly:只显示最后一栏。
NavigationSplitView 的每一栏都可以使用下面的方法设置宽度:
以上所介绍的在示例中都有体现,代码也不复杂,关于 NavigationSplitView 就简单介绍到这里。
此外,NavigationSplitView 中的 detail 可以嵌套使用 NavigationStack 来实现更加复杂的导航行为。