用途:为 iPhone Duo 适配竖轴工具栏、导航栏和标签栏。该设备屏幕更宽更矮,系统把原本位于顶部和底部的控件移到侧边,内容区保持完整。
主要能力:同一组件在不同轴向呈现;导航、工具栏与标签栏控件共用一个竖向区域;支持项目排序层级(导航项、突出操作、其余项);系统根据图标与标题推断表示形式,图标项走竖向、纯文字项保持横向;提供 axisBehavior 覆盖推断;支持溢出菜单合并与可见性优先级;支持按视图选择工具栏优先或标签栏优先压缩。
必要用法:必须用最新 SDK 重新构建,并使用导航容器提供的栏(SwiftUI 用 NavigationStack 或 NavigationSplitView 配合 toolbar;UIKit 用 UINavigationController 和 UITabBarController)。手工用 UIToolbar、UINavigationBar 或 UITabBar 构建的栏不会参与竖向布局。每个项目应同时提供标题和图像。用 ToolbarItemGroup / UIBarButtonItemGroup 表达分组而非手动加间距。用 toolbarVerticalEdge 判断系统偏好的竖向栏边缘。用 toolbarVerticalBehavior / preferredVerticalBarBehavior 选择退出。
适用场景:导航驱动界面、任务驱动界面、分栏视图(仅详情列参与)、检查器、表单、键盘附件栏(始终跟随键盘,不转竖向)。
限制:分栏视图仅详情列参与;展开的检查器没有自己的竖向栏;内屏竖屏保持横向栏;内屏表单居中且项目保持横向;右到左语言中栏仍对齐硬件侧;竖向栏默认无滚动边缘效果,开启降低透明度时会有背景;弹性间距在竖向轴上折叠为零。默认不建议关闭侧边控件,例外仅限无需栏的沉浸式界面和控件很少的表单。