如何在iPad上以编程方式将NavigationSplitView折叠为单列

核心思路 #

通过监听SwiftUI的dynamicTypeSize环境变量，判断当前字体缩放等级是否超过自定义阈值，动态切换显示双列NavigationSplitView或单列NavigationStack，模拟iPhone端的折叠布局行为。

具体实现步骤 #

1. 监听动态字体大小
   在根视图中注入环境变量，获取当前系统的动态字体缩放等级：

@Environment(\.dynamicTypeSize) private var dynamicTypeSize

2. 定义折叠阈值
   根据需求设定触发折叠的字体等级阈值，示例中以超过.xxxLarge为例：

private var shouldCollapseToSingleColumn: Bool {
    dynamicTypeSize > .xxxLarge
}

你可根据实际测试调整阈值，可选等级包括：.xSmall, .small, .medium, .large, .xLarge, .xxLarge, .xxxLarge, .accessibility1至.accessibility6。

3. 动态切换导航结构
   在根视图的body中，根据阈值判断结果选择对应布局，同时共享选中状态：

@State private var selectedItem: YourDataType? // 替换为你的实际数据模型类型

var body: some View {
    if shouldCollapseToSingleColumn {
        // 单列导航（匹配iPhone端折叠逻辑）
        NavigationStack {
            SidebarView(selectedItem: $selectedItem)
                .navigationTitle("侧边栏")
            if let item = selectedItem {
                DetailView(item: item)
            }
        }
    } else {
        // 双列导航（默认iPad布局）
        NavigationSplitView {
            SidebarView(selectedItem: $selectedItem)
        } detail: {
            DetailView(item: selectedItem)
        }
    }
}

其中SidebarView和DetailView为你已实现的侧边栏、详情页视图，只需确保二者通过绑定共享selectedItem状态即可。

4. 进阶优化（可选）
   若需要更精细的缩放比例判断（而非预设等级），可通过UIFontMetrics计算实际缩放系数：

private var shouldCollapse: Bool {
    // 以系统默认17号字体为基准，计算缩放比例
    let scaleFactor = UIFontMetrics.default.scaledValue(for: 17) / 17
    return scaleFactor > 2.0 // 自定义缩放比例阈值
}

原方案无效原因说明 #

• horizontalSizeClass是系统自动计算的只读属性，无法手动修改；
• .navigationSplitViewColumnWidth(0)无法彻底隐藏侧边栏，NavigationSplitView的布局逻辑会维持最小列宽限制；
• 旧版StackNavigationViewStyle在iOS16中已被废弃，不再作用于NavigationSplitView。

内容的提问来源于stack exchange，提问作者JohnSF