MenuBuilder

一个用于创建 NSMenu 的函数构建器，在精神上类似于 SwiftUI 的 ViewBuilder。

使用示例 (请参阅演示或阅读文档了解更多详情)

let menu = NSMenu {
  MenuItem("Click me")
    .onSelect { print("clicked!") } 
  MenuItem("Item with a view")
    .view {
      MyMenuItemView() // any SwiftUI view
    }
  SeparatorItem()
  MenuItem("About") {
    // rendered as disabled items in a submenu
    MenuItem("Version 1.2.3")
    MenuItem("Copyright 2021")
  }
  MenuItem("Quit")
    .shortcut("q")
    .onSelect { NSApp.terminate(nil) }
}

// later, to replace the menu items with different/updated ones:
menu.replaceItems {
  MenuItem("Replaced item").onSelect { print("Hello!") }
}

请注意，目前没有办法保留现有的菜单项，尽管应该可以实现这个功能——如果您需要更新支持，欢迎提出 issue 或 PR！

• (可能破坏性变更) 当您的应用程序的部署目标为 macOS 12 或更高版本时，将字符串字面量传递给 MenuItem("Title Here") 现在将创建一个 String.LocalizationValue，如果您使用 MenuBuilder，这将更容易本地化您的应用程序。
  • 如果您的应用程序未本地化（或您的部署目标是 macOS 11 或更早版本），您不应该注意到任何变化。
  • 如果您的应用程序已本地化，请查看使用 MenuBuilder 的 UI，并确保您没有获得任何意外的翻译。如果您想选择退出新行为，您可以迁移到 MenuItem(verbatim: "Title Here")。
  • 感谢 @ShikiSuen 启动了这个项目！

查看新的 API 文档！ https://menubuilder.jedfox.com

新功能

• 添加 action 和 tag 修饰符 (感谢 @patr0nus!)
• 更新 SwiftUI 自定义视图包装器以使用 Auto Layout (感谢 @rurza!)
• 添加对 macOS 12+ 上使用 AttributedString 设置菜单项标题的支持
• 向 NSMenu 添加一个便捷初始化器，它接受一个 title 和一个 @MenuBuilder 闭包
• 弃用 MenuItem(_:children:) 初始化器，推荐使用 MenuItem(title).submenu { ... children ... }
• 添加一个 onSelect(target:action:) 便捷方法，用于同时设置 target 和 action。

Bug修复

• 更新 SwiftUI 自定义视图包装器的选择指示器，以匹配 macOS Big Sur 及更高版本的菜单样式 (感谢 @rurza!)
• 使 toolTip 的参数成为可选参数 (感谢 @mlch911!)
• 当您使用 replaceItems API 时，现在会在 NSMenu 上调用 update()

• (破坏性变更) 迁移到 @resultBuilder (现在需要 Xcode 12.5+)
• 将修饰符应用于快捷键
• 添加一个 MenuItem.set(WriteableKeyPath, to: Value) 方法，使其更容易自定义菜单项
• 添加一个 MenuItem.apply { menuItem in } 方法，允许任意自定义菜单项
• 添加 IndentGroup 以更容易地缩进多个相邻菜单项
• 添加 CustomMenuItem，它允许您在 MenuBuilder 中包含 NSMenuItem 的自定义子类

修复 & 清理

添加循环支持

添加条件支持

添加许可证，清理代码

初始版本！

打开 MenuBuilder.xcworkspace 以同时查看包和演示。 欢迎 PR 和 issue！