UIPageViewController滑动时忽略SwiftUI navigationBarHidden(true)设置如何解决

该问题由SwiftUI和UIKit导航栏状态的优先级冲突导致：
SwiftUI的navigationBarHidden(_:)修饰符是基于视图层级的状态传递规则生效，而你封装的UIPageViewController每次切换子页面时，UIKit层的UINavigationController会优先读取当前显示的UIHostingController的prefersNavigationBarHidden属性，该属性默认值为false，会直接覆盖SwiftUI上层的导航栏隐藏配置，触发导航栏意外显示。

提供两种落地方式，可根据需求选择：

方案1：最小改动，强制控制UIKit导航栏状态 #

直接操作UIKit层的导航栏显隐，优先级最高，不受子控制器切换影响：

1. 新增导航栏强制控制的工具扩展

extension View {
    func forceNavigationBarHidden(_ hidden: Bool) -> some View {
        background(UIKitNavigationBarAccessor { navVC in
            navVC.navigationBar.isHidden = hidden
        })
    }
}

struct UIKitNavigationBarAccessor: UIViewControllerRepresentable {
    let callback: (UINavigationController) -> Void
    
    func makeUIViewController(context: Context) -> UIViewController {
        UIViewController()
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
        DispatchQueue.main.async {
            if let navVC = uiViewController.navigationController {
                callback(navVC)
            }
        }
    }
}

2. 替换ContentView中的导航栏控制修饰符
   将原来的.navigationBarHidden(hidden)替换为.forceNavigationBarHidden(hidden)即可。

方案2：修改PagerView适配原生导航规则 #

从子控制器层面同步导航栏隐藏状态，符合UIKit原生行为规范：

1. 给PagerView新增导航栏隐藏状态绑定

struct PagerView<Data: RandomAccessCollection, Page: View>: UIViewControllerRepresentable {
    // 原有属性不变
    @Binding var navigationBarHidden: Bool // 新增属性
    
    // 初始化方法新增对应参数
    init(
        _ data: Data,
        currentPage: Binding<Data.Index>,
        navigationBarHidden: Binding<Bool>, // 新增参数
        interPageSpacing: CGFloat = 0,
        @ViewBuilder content: @escaping (Data.Element) -> Page
    ) {
        self.data = data
        self._currentPage = currentPage
        self._navigationBarHidden = navigationBarHidden // 绑定属性
        self.interPageSpacing = interPageSpacing
        self.content = content
    }

2. 修改PageViewController重写导航栏属性

class PageViewController<Content: View>: UIHostingController<Content> {
    var index: Data.Index
    var isNavigationBarHidden: Bool // 新增属性
    // 重写导航栏隐藏偏好，优先级高于SwiftUI上层修饰符
    override var prefersNavigationBarHidden: Bool { isNavigationBarHidden }

    init(rootView: Content, index: Data.Index, isNavigationBarHidden: Bool) { // 初始化新增参数
        self.index = index
        self.isNavigationBarHidden = isNavigationBarHidden
        super.init(rootView: rootView)
    }

    // 原有init?(coder:)和viewDidLoad()不变
}

3. 同步状态到子控制器

//  Coordinator的page(for index:)方法传参
func page(for index: Data.Index) -> PageViewController<Page> {
    return PageViewController(
        rootView: parent.content(parent.data[index]),
        index: index,
        isNavigationBarHidden: parent.navigationBarHidden // 传入状态
    )
}

//  updateUIViewController方法新增状态同步逻辑
func updateUIViewController(_ uiViewController: UIPageViewController, context: Context) {
    // 原有页面切换逻辑不变
    
    // 新增：同步导航栏隐藏状态到当前显示的页面
    if let currentPageVC = uiViewController.viewControllers?.first as? PageViewController<Page> {
        currentPageVC.isNavigationBarHidden = context.coordinator.parent.navigationBarHidden
        currentPageVC.setNeedsNavigationBarAppearanceUpdate()
    }
}

4. ContentView使用时传入状态

var body: some View {
    PagerView(0..<100, currentPage: $currentPage, navigationBarHidden: $hidden) {
        // 原有页面构建逻辑不变
    }
    .navigationBarHidden(hidden)
    // 其余修饰符不变
}

内容的提问来源于stack exchange，提问作者Vukašin Manojlović