macOS SwiftUI NavigationView侧边栏左滑消失 禁止完全隐藏

在macOS端使用SwiftUINavigationView组件时，侧边导航面板向左滑动至最左侧边缘会完全消失，以下针对两个核心问题给出对应方案。

问题1：找回已消失的左侧导航面板 #

有三种通用唤出方式：

• 鼠标移动到窗口最左边缘，待出现侧边栏拖拽把手后，按住向右拖拽即可拉出面板
• 点击顶部系统菜单栏「显示」-「显示侧边栏」（部分macOS版本路径为「视图」-「显示侧边栏」）直接唤出
• 触控板用户双指从触控板左边缘向右滑动，可通过系统侧滑手势唤出隐藏的侧边栏

问题2：禁止侧边栏完全滑动隐藏，仅保留宽度拖拽调整能力 #

SwiftUI原生NavigationView没有直接暴露侧边栏最小宽度的配置接口，需要通过AppKit层的NSSplitView代理方法实现约束：给侧边栏设置最小宽度阈值，同时禁止侧边栏分栏折叠，即可实现拖拽调宽但不会完全隐藏的效果。

问题复现代码 #

struct ColorDetail: View {
    var color: Color

    var body: some View {
        color
            .frame(width: 200, height: 200)
            .navigationTitle(color.description.capitalized)
    }
}

struct ContentView: View {
    var body: some View {
        NavigationView {
            List {
                NavigationLink("Purple", destination: ColorDetail(color: .purple))
                NavigationLink("Pink", destination: ColorDetail(color: .pink))
                NavigationLink("Orange", destination: ColorDetail(color: .orange))
            }
            .navigationTitle("Colors")
            
            Text("Select a Color") // 未选中颜色时的占位视图
        }
    }
}

问题运行效果 #

可行实现代码 #

通过自定义ViewModifier注入NSSplitView代理，约束侧边栏最小宽度、禁止折叠：

import SwiftUI
import AppKit

// 侧边栏最小宽度配置修饰器
struct SidebarMinWidthModifier: ViewModifier {
    let minWidth: CGFloat
    
    func body(content: Content) -> some View {
        content
            .background(SplitViewConfig(minWidth: minWidth))
    }
}

struct SplitViewConfig: NSViewRepresentable {
    let minWidth: CGFloat
    
    func makeNSView(context: Context) -> NSView {
        let view = NSView()
        DispatchQueue.main.async {
            // 查找视图层级中的NSSplitView实例
            guard let splitView = view.superview?.superview as? NSSplitView else { return }
            splitView.delegate = context.coordinator
            splitView.autosaveName = NSSplitView.AutosaveName("CustomNavigationSplitView")
        }
        return view
    }
    
    func updateNSView(_ nsView: NSView, context: Context) {}
    
    func makeCoordinator() -> Coordinator {
        Coordinator(minWidth: minWidth)
    }
    
    class Coordinator: NSObject, NSSplitViewDelegate {
        let minWidth: CGFloat
        
        init(minWidth: CGFloat) {
            self.minWidth = minWidth
        }
        
        // 约束侧边栏最小拖拽位置
        func splitView(_ splitView: NSSplitView, constrainMinCoordinate proposedMinimumPosition: CGFloat, ofSubviewAt dividerIndex: Int) -> CGFloat {
            if dividerIndex == 0 {
                return minWidth
            }
            return proposedMinimumPosition
        }
        
        // 禁止侧边栏分栏折叠隐藏
        func splitView(_ splitView: NSSplitView, canCollapseSubview subview: NSView) -> Bool {
            if subview == splitView.subviews.first {
                return false
            }
            return true
        }
    }
}

extension View {
    func sidebarMinWidth(_ width: CGFloat) -> some View {
        self.modifier(SidebarMinWidthModifier(minWidth: width))
    }
}

// 业务代码调整
struct ColorDetail: View {
    var color: Color

    var body: some View {
        color
            .frame(width: 200, height: 200)
            .navigationTitle(color.description.capitalized)
    }
}

struct ContentView: View {
    var body: some View {
        NavigationView {
            List {
                NavigationLink("Purple", destination: ColorDetail(color: .purple))
                NavigationLink("Pink", destination: ColorDetail(color: .pink))
                NavigationLink("Orange", destination: ColorDetail(color: .orange))
            }
            .navigationTitle("Colors")
            .sidebarMinWidth(200) // 配置侧边栏最小宽度为200pt，可按需调整

            Text("Select a Color")
        }
    }
}

该方案不会影响NavigationView原生的导航跳转、标题显示等所有功能，侧边栏可正常拖拽调整宽度，向左拖拽到设定的最小宽度后就无法继续滑动，不会出现完全隐藏的情况。

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