SwiftUI 客製 macOS App 螢幕上方的選單列

使用 commandsReplaced(content:) 可以完全替換掉目前 Scene 的所有 command。

更換 macOS 預設的選單列

所有的 Scene type，如：WindowGroup、Window ⋯⋯ 都有預設的一組 command，這裡的 command 指的是 Mac 螢幕上方的選單列中的功能。只要對 Scene 使用 commandsReplaced(content:) 就可以把這些預設的 command 換成自己客製的選單列。

@main
struct Example: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .commandsReplaced {
            CommandGroup(after: .pasteboard) {
                Section {
                    Button("Show Clipboard") {
                        // open window
                    }
                }
            }
        }
    }
}

這裡會移除所有預設的 command，並把「Show Clipboard」功能放在處理剪貼簿的選單列後方。

CommandGroup

在 commandsReplaced 裡，可以用 CommandGroup 加入一組功能列，CommandGroup 有三個 init：

// 把自訂 command 加在指定位置的後方
init(after: CommandGroupPlacement, addition: () -> Content)

// 把自訂 command 加在指定位置的前方
init(before: CommandGroupPlacement, addition: () -> Content)

// 用自訂 command 取代指定的位置
init(replacing: CommandGroupPlacement, addition: () -> Content)

這裡會發現，init CommandGroup 會需要給定 CommandGroupPlacement，而後面的 addition 就是我們想加入選單列的功能，用 Section 加 Button 就可以了。

CommandGroupPlacement

CommandGroupPlacement 是 Apple 定義的 command 標準位置，並不會顯示在 UI 上，想把自訂義功能加到什麼位置可以參考下方的整理。主要分成六大類：

App interactions：

File manipulation：

Content updates：

Bars：

Windows：

Help：

討論

不過最後有個小地方要注意，因為 macOS 不會讓 App 自己名字的選單為空，也就是說，如果我們沒有任何 App interactions 的類別，那後方最靠近的功能就會遞補進來。舉例來說，我們不使用 App interactions 類別，那後面依序還有「File manipulation、Content updates、Bar、Windows、Help」，這時 File 選單列會消失，裡面的功能就會遞補進 App interactions。