用途:为 iPhone Duo 适配竖向轴上的工具栏、导航栏与标签栏。该设备屏幕更宽更短,系统把通常位于顶部和底部的控件移到侧边,内容区不受影响;内屏竖屏保留横向栏。
主要能力与要求:必须针对最新 SDK 重新构建,并使用导航容器提供的栏(SwiftUI 的 toolbar 配合 NavigationStack 或 NavigationSplitView;UIKit 用 UINavigationController、UITabBarController)。手工用 UIToolbar、UINavigationBar、UITabBar 构建的栏不会参与竖向布局。竖向区域中导航、工具栏与标签栏控件共存;分栏视图仅详情列参与,检查器展开时无独立竖向栏。
项目排序自上而下:主导航(返回、关闭)、突出操作(完成等)、其余项保持原分组。为每项同时提供标题与图像;竖向栏宽度固定、高度灵活,倾向仅符号表示,纯文本项保持横向;系统也会判断项目是否适合竖向轴。文本为补充信息时可改为符号加徽章,运行总数等不可省略的文本保持横向。
用法与限制:需要时用 AxisBehavior 强制横向或允许竖向,并让相关项保持同一轴。用 toolbarVerticalEdge 判断系统偏好的竖向栏边缘,注意语义是“若有竖向栏,它属于这一侧”。自定义视图需适配固定宽度或自行竖向布局;用分组(ToolbarItemGroup、UIBarButtonItemGroup)表达间距关系,不要手工加间距。溢出更易发生,需先决定工具栏或标签栏先压缩,把自定义溢出并入系统菜单,并用可见性优先级控制折叠顺序。默认不建议关闭竖向行为,仅在无需栏的全宽界面或控件很少的 sheet 等有限场景下用 toolbarVerticalBehavior 或 preferredVerticalBarBehavior 退出。键盘辅助栏始终跟随键盘,不会移入竖向轴。资料未提供具体 API 版本细节以外的更多实现示例。