先前寫過一篇用 Swift 開發 macOS 狀態欄(menu bar)App 的筆記,但那篇漏了一個實用的小技巧:如何把狀態欄的 icon 換成圓餅型的進度指示器。當 App 正在處理某件事時,用進度圈來提示使用者,體驗會好很多。

核心思路是建立一個 NSProgressIndicator,設定範圍與初始值,然後加到 NSStatusItem 的 button 檢視上。
/// 在狀態欄顯示圓餅型進度
private func showStatusItemProgress() {
if let button = statusItem.button {
// FIXME: 這樣可以動,但顯然不是好作法
button.subviews.removeAll()
}
if let button = statusItem.button {
// FIXME: 這樣可以動,但顯然不是好作法
let frame = NSRect(x: 6, y: 2, width: 18, height: 18)
let progressIndicator = NSProgressIndicator(frame: frame)
progressIndicator.style = .SpinningStyle
progressIndicator.indeterminate = false
progressIndicator.minValue = 0
progressIndicator.maxValue = 100
progressIndicator.doubleValue = 0
self.progressIndicator = progressIndicator
// 加上進度條後,狀態欄的 frame 尺寸會出錯,
// 目前還沒找到正解,但塞一張圖片進去可以繞過這個問題
statusItem.image = NSImage(named: "EmptyIcon")
statusItem.image?.template = true
button.addSubview(progressIndicator)
}
}
第一,一定要加在 button 上,不要加在 view 上。如果加到 view,view 會蓋住狀態欄的點擊事件,NSStatusItem 就再也收不到使用者點擊了。除非你的 App 確實不需要回應點擊,否則別這麼做。
第二,那張「空白圖片」不是多餘的。加入進度指示器之後,狀態欄的 frame 尺寸會算錯,塞一張透明圖片進 statusItem.image 剛好能繞開這個問題。
如果你知道 frame 尺寸錯誤的正確解法,歡迎分享——目前這個 workaround 雖然醜,但至少穩定可用。