Mac Catalyst中NavigationSplitView详情容器致Sheet快捷键失效问题

问题描述 #

在SwiftUI开发的Mac Catalyst应用中，Sheet内Button的.keyboardShortcut修饰符在多数场景正常工作，但当Sheet从NavigationSplitView详情列中被ZStack、VStack等容器视图包裹的视图弹出时，快捷键会无提示失效。

代码示例 #

@main
struct TestApp: App {
    @State private var page: Int = 0

    var body: some Scene {
        WindowGroup {
            NavigationSplitView {
                List {
                    Button("Settings") { page = 0 }
                }
            } detail: {
                //PageA()  // ✅ 快捷键正常工作
                PageB()    // ❌ 快捷键失效
                //PageC()  // ❌ 快捷键失效
            }
        }
    }
}

struct PageA: View {
    var body: some View {
        ShortcutView() // 直接子视图——正常工作
    }
}

struct PageB: View {
    var body: some View {
        ZStack {
            ShortcutView() // 被ZStack包裹——失效
        }
    }
}

struct PageC: View {
    var body: some View {
        VStack {
            ShortcutView() // 被VStack包裹——失效
        }
    }
}

struct ShortcutView: View {
    @State private var isPresented = false

    var body: some View {
        Button("Present") { isPresented.toggle() }
            .sheet(isPresented: $isPresented) {
                Button("Do something") { print("pressed") }
                    .keyboardShortcut("s", modifiers: .command)
                    .interactiveDismissDisabled()
            }
    }
}

问题解答 #

1. 失效原因 #

这是SwiftUI在Mac Catalyst平台下的视图层级焦点传递Bug：当Sheet的展示者被包裹在ZStack/VStack这类容器视图中时，NavigationSplitView详情列的焦点上下文无法正确传递给Sheet的快捷键注册系统，导致Sheet内的快捷键无法被添加到全局快捷键池，自然无法触发。

2. 可靠解决方法 #

方案一：App层级全局注册快捷键（推荐）

通过CommandGroup在App场景中注册全局快捷键，配合Sheet的展示状态判断是否响应，完全不受视图层级影响。

修改后的代码示例：

@main
struct TestApp: App {
    @State private var page: Int = 0
    @State private var isSheetPresented = false // 全局管理Sheet展示状态

    var body: some Scene {
        WindowGroup {
            NavigationSplitView {
                List {
                    Button("Settings") { page = 0 }
                }
            } detail: {
                PageB()
                    .environment(\.isSheetPresented, $isSheetPresented) // 传递状态到子视图
            }
        }
        .commands {
            CommandGroup(after: .appSettings) {
                Button("Do something") {
                    // 仅当Sheet处于展示状态时执行动作
                    if isSheetPresented {
                        print("pressed")
                    }
                }
                .keyboardShortcut("s", modifiers: .command)
            }
        }
    }
}

// 自定义环境键，用于传递Sheet状态
private struct IsSheetPresentedKey: EnvironmentKey {
    static let defaultValue: Binding<Bool> = .constant(false)
}

extension EnvironmentValues {
    var isSheetPresented: Binding<Bool> {
        get { self[IsSheetPresentedKey.self] }
        set { self[IsSheetPresentedKey.self] = newValue }
    }
}

struct ShortcutView: View {
    @Environment(\.isSheetPresented) private var isPresented

    var body: some View {
        Button("Present") { isPresented.wrappedValue.toggle() }
            .sheet(isPresented: isPresented) {
                Text("Sheet Content")
                    .interactiveDismissDisabled()
            }
    }
}

方案二：强制Sheet获取焦点

给Sheet的根视图添加.focusable()，并在Sheet出现时强制设置第一响应者，让Sheet的视图层级捕获快捷键。

修改ShortcutView中的Sheet部分：

struct ShortcutView: View {
    @State private var isPresented = false

    var body: some View {
        Button("Present") { isPresented.toggle() }
            .sheet(isPresented: $isPresented) {
                VStack {
                    Button("Do something") { print("pressed") }
                        .keyboardShortcut("s", modifiers: .command)
                }
                .focusable()
                .onAppear {
                    DispatchQueue.main.async {
                        // 重置并强制Sheet获取焦点
                        NSApp.keyWindow?.makeFirstResponder(nil)
                        NSApp.keyWindow?.makeFirstResponder(NSApp.keyWindow?.contentViewController?.view)
                    }
                }
                .interactiveDismissDisabled()
            }
    }
}

注意：方案二依赖焦点管理，在复杂视图场景下可能存在不稳定情况；方案一为全局注册，是最可靠的解决方案。

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