iOS 26中设置largeSubtitleTextAttributes无效果的问题咨询

问题表现 #

自定义导航栏大标题与副标题样式时，UINavigationBarAppearance 的 largeSubtitleTextAttributes 设置完全无效：

• 标题可正常在大标题（绿色）和行内标题（蓝色）模式间切换样式；
• 副标题始终应用 subtitleTextAttributes 的红色设置，即使在大标题模式下也不触发黄色的 largeSubtitleTextAttributes；
• 移除 subtitleTextAttributes 后，副标题在两种模式下均显示默认颜色，largeSubtitleTextAttributes 依然无作用。

该问题在 SwiftUI NavigationStack 和 UIKit UINavigationController 中表现一致，但 UIKit 直接使用 navigationItem.largeAttributedSubtitle 和 navigationItem.attributedSubtitle 可正常切换副标题样式。

复现代码 #

SwiftUI 视图代码

NavigationStack {
    // content
    .navigationTitle("Title")
    .navigationSubtitle("Subtitle")
}

外观配置代码

let appearance = UINavigationBarAppearance()

// 大标题样式
appearance.largeTitleTextAttributes = [.foregroundColor: UIColor.green]
appearance.largeSubtitleTextAttributes = [.foregroundColor: UIColor.yellow]

// 行内标题样式
appearance.titleTextAttributes = [.foregroundColor: UIColor.blue]
appearance.subtitleTextAttributes = [.foregroundColor: UIColor.red]
        
let navAppearance = UINavigationBar.appearance()
navAppearance.standardAppearance = appearance

现象对比 #

大标题模式	行内标题模式

问题原因 #

这是 iOS 16 及以上版本中 UINavigationBarAppearance 的已知问题：系统未正确区分大标题模式下的副标题样式逻辑，始终复用行内标题的 subtitleTextAttributes 设置，忽略 largeSubtitleTextAttributes 配置。

临时解决方案 #

方案1：监听滚动状态动态切换样式 #

通过监听滚动视图偏移量，判断导航栏是否处于大标题模式，动态更新 subtitleTextAttributes：

NavigationStack {
    ScrollView {
        // 你的内容
        Text("示例内容")
            .padding(20)
    }
    .navigationTitle("Title")
    .navigationSubtitle("Subtitle")
    .onAppear {
        updateSubtitleStyle(isLargeTitle: true)
    }
    .onScrollViewOffsetChange { offset in
        // 根据偏移量阈值判断大标题状态，阈值可自行调整
        let isLargeTitle = offset < -100
        updateSubtitleStyle(isLargeTitle: isLargeTitle)
    }
}

// 动态更新副标题样式
func updateSubtitleStyle(isLargeTitle: Bool) {
    let appearance = UINavigationBarAppearance()
    appearance.largeTitleTextAttributes = [.foregroundColor: UIColor.green]
    appearance.titleTextAttributes = [.foregroundColor: UIColor.blue]
    
    appearance.subtitleTextAttributes = isLargeTitle 
        ? [.foregroundColor: UIColor.yellow] 
        : [.foregroundColor: UIColor.red]
    
    UINavigationBar.appearance().standardAppearance = appearance
    UINavigationBar.appearance().scrollEdgeAppearance = appearance
}

// 扩展：监听ScrollView偏移量
extension View {
    func onScrollViewOffsetChange(_ action: @escaping (CGFloat) -> Void) -> some View {
        self.background(
            GeometryReader { proxy in
                Color.clear
                    .preference(key: ScrollOffsetKey.self, value: proxy.frame(in: .named("scroll")).minY)
            }
        )
        .onPreferenceChange(ScrollOffsetKey.self, perform: action)
        .coordinateSpace(name: "scroll")
    }
}

struct ScrollOffsetKey: PreferenceKey {
    static var defaultValue: CGFloat = 0
    static func reduce(value: inout CGFloat, nextValue: () -> CGFloat) {}
}

方案2：UIKit 包裹 SwiftUI 视图 #

通过 UIViewControllerRepresentable 封装 UIKit 导航控制器，直接使用 navigationItem 的两个属性设置不同模式的副标题：

struct UIKitNavigationWrapper<Content: View>: UIViewControllerRepresentable {
    let content: Content
    
    func makeUIViewController(context: Context) -> UINavigationController {
        let hostingVC = UIHostingController(rootView: content)
        let navVC = UINavigationController(rootViewController: hostingVC)
        
        // 配置不同模式的副标题
        let largeSubtitle = NSAttributedString(
            string: "Subtitle", 
            attributes: [.foregroundColor: UIColor.yellow]
        )
        let inlineSubtitle = NSAttributedString(
            string: "Subtitle", 
            attributes: [.foregroundColor: UIColor.red]
        )
        
        hostingVC.navigationItem.largeAttributedSubtitle = largeSubtitle
        hostingVC.navigationItem.attributedSubtitle = inlineSubtitle
        
        // 配置标题样式
        let appearance = UINavigationBarAppearance()
        appearance.largeTitleTextAttributes = [.foregroundColor: UIColor.green]
        appearance.titleTextAttributes = [.foregroundColor: UIColor.blue]
        navVC.navigationBar.standardAppearance = appearance
        navVC.navigationBar.scrollEdgeAppearance = appearance
        hostingVC.navigationItem.largeTitleDisplayMode = .automatic
        
        return navVC
    }
    
    func updateUIViewController(_ uiViewController: UINavigationController, context: Context) {}
}

// 使用方式
struct ContentView: View {
    var body: some View {
        UIKitNavigationWrapper {
            Text("Hello World")
                .padding()
        }
    }
}

总结 #

当前 iOS 版本中 UINavigationBarAppearance.largeSubtitleTextAttributes 确实存在未生效的问题，可通过上述方案临时绕过。建议同时向苹果提交 Bug 报告，等待官方修复。

内容的提问来源于stack exchange，提问作者Matt Le Fleur