NavigationStack中添加副标题的官方标准方法是什么？

DevOps 小满

2026-7-13

iOS 16+ NavigationStack 原生副标题实现方案

在iOS 16及后续版本中，Apple提供了替代iOS 15中navigationSubtitle的原生方案，无需通过自定义toolbar模拟，从根源避免UI冲突问题，具体有两种官方推荐方式：

1. 组合式`navigationTitle`实现（iOS 16+）

直接在navigationTitle的闭包中传入包含主标题和副标题的组合视图，配合navigationBarTitleDisplayMode控制显示样式：

NavigationStack {
    Text("页面内容")
        .navigationTitle {
            VStack(alignment: .leading, spacing: 4) {
                Text("主标题")
                    .font(.headline)
                Text("副标题")
                    .font(.subheadline)
                    .foregroundColor(.secondary)
            }
        }
        .navigationBarTitleDisplayMode(.inline)
}

这种方式完全复用原生导航栏布局逻辑，不会出现自定义toolbar时的组件覆盖、布局偏移等问题。

2. iOS 17+ 简化版实现

iOS 17优化了导航栏自定义能力，无需额外设置displayMode，系统会自动适配设备尺寸和导航状态：

NavigationStack {
    Text("页面内容")
        .navigationTitle {
            VStack(alignment: .leading, spacing: 2) {
                Text("主标题")
                    .font(.title2)
                Text("副标题")
                    .font(.caption)
                    .foregroundColor(.secondary)
            }
        }
}