SwiftUI侧边栏列表项上下文菜单快捷键无法触发问题

问题说明 #

侧边栏的每个列表项都带有右键上下文菜单，菜单内按钮设置了快捷键（如Command+C），但这些快捷键无法触发对应操作。

问题原因 #

直接给contextMenu内的按钮添加keyboardShortcut不会生效——这些快捷键属于单个列表项的视图，只有当该列表项的上下文菜单处于激活状态时才可能响应，但实际使用中用户通常期望选中项目后直接通过快捷键执行操作，而非先打开菜单。

解决方案 #

将快捷键绑定到全局作用域（如工具栏），关联当前选中的列表项，这样只要有选中项，就能通过快捷键触发操作，同时保留上下文菜单的原有功能。

修改后的完整代码：

struct ContentView: View {
    private let data: [Item] = [
        Item(label:"one"),
        Item(label:"two"),
        Item(label:"three"),
        Item(label:"four"),
        Item(label:"five")
    ]

    @State private var selected: Item?

    var body: some View {
        NavigationSplitView {
            List(selection: $selected) {
                ForEach(data, id: \.id) { item in
                    Text(item.label)
                        .contextMenu {
                            Button("Copy label") {
                                copyLabel(item: item)
                            }
                        }
                        .tag(item)
                }
            }
            // 添加全局快捷键，仅选中项目时可用
            .toolbar {
                ToolbarItem(placement: .keyboard) {
                    Button("Copy label") {
                        guard let selectedItem = selected else { return }
                        copyLabel(item: selectedItem)
                    }
                    .keyboardShortcut("c", modifiers: [.command])
                    .disabled(selected == nil)
                }
            }
        } detail: {
            selected.map(DestinationView.init(item:)) ?? PlaceholderView()
        }
    }

    // 提取复制逻辑为单独方法，复用代码
    private func copyLabel(item: Item) {
        let pasteboard = NSPasteboard.general
        pasteboard.clearContents()
        pasteboard.setString(item.label, forType: .string)
    }
}

关键改动点 #

1. 将复制逻辑提取为私有方法copyLabel(item:)，避免代码重复
2. 在List的toolbar中添加全局快捷键按钮，绑定Command+C
3. 快捷键按钮根据selected状态启用/禁用，确保只有选中项目时才能触发操作

内容的提问来源于stack exchange，提问作者Stef Kors