如何在显示支持动态操作之前修改 UIMenu

How to modify UIMenu before it's shown to support dynamic actions

iOS 14 添加了在点击或长按 UIBarButtonItem 或 UIButton 时显示菜单的功能,如下所示:

let menu = UIMenu(children: [UIAction(title: "Action", image: nil) { action in
    //do something
}])
button.menu = menu
barButtonItem = UIBarButtonItem(title: "Show Menu", image: nil, primaryAction: nil, menu: menu)

这最常替换动作 sheets(UIAlertControlleractionSheet 风格)。动态操作 sheet 非常常见,其中仅包含或可能根据用户点击按钮时的某些状态禁用操作。但是使用这个API,菜单是在创建按钮的时候创建的。如何在显示菜单之前修改菜单或以其他方式使其动态化以确保适当的操作可用并在出现时处于正确的状态?

您可以存储对条形按钮项或按钮的引用,并在每次影响菜单中可用操作的任何状态更改时重新创建菜单。 menu 是可设置的 属性,因此可以在创建按钮后随时更改。您还可以获取当前菜单并像这样替换其子菜单:button.menu = button.menu?.replacingChildren([])

例如,对于状态更改时未通知您的情况,您确实需要能够在菜单出现之前立即更新菜单。有一个 UIDeferredMenuElement API 允许动态生成动作。这是一个块,您可以在其中调用提供 UIMenuElement 数组的完成处理程序。 loading UI 的占位符是系统添加的,一旦调用completion handler 就会被替换,所以它支持菜单项的异步确定。但是,这个块只被调用一次,然后被缓存并重用,所以这不能满足我们在这种情况下的需要。 iOS 15 添加了一个新的 uncached provider API 除了每次显示元素时都会调用块外,它的行为方式相同,这正是我们在这种情况下所需要的。

barButtonItem.menu = UIMenu(children: [
    UIDeferredMenuElement.uncached { [weak self] completion in
        var actions = [UIMenuElement]()
        if self?.includeTestAction == true {
            actions.append(UIAction(title: "Test Action") { [weak self] action in
                self?.performTestAction()
            })
        }
        completion(actions)
    }
])

在此 API 存在之前,我确实发现 UIButton 您可以在用户通过 target/action 按下时更改菜单,如下所示:button.addTarget(self, action: #selector(buttonTouchedDown(_:)), for: .touchDown)。这仅在 showsMenuAsPrimaryAction 为 false 时有效,因此他们必须长按才能打开菜单。我没有找到 UIBarButtonItem 的解决方案,但您可以使用 UIButton 作为自定义视图。

经过一番尝试,我发现您可以通过将 menu 属性 设置为 null 来修改 UIButton.menu首先然后设置新的 UIIMenu

这是我制作的示例代码

@IBOutlet weak var button: UIButton!

func generateMenu(max: Int, isRandom: Bool = false) -> UIMenu {
    let n = isRandom ? Int.random(in: 1...max) : max
    print("GENERATED MENU: \(n)")
    let items = (0..<n).compactMap { i -> UIAction in
        UIAction(
            title: "Menu \(i)",
            image: nil
        ) {[weak self] _ in
            guard let self = self else { return }

            self.button.menu = nil // HERE

            self.button.menu = self.generateMenu(max: 10, isRandom: true)
            print("Tap")
        }
    }
 
    let m = UIMenu(
        title: "Test", image: nil,
        identifier: UIMenu.Identifier(rawValue: "Hello.menu"),
        options: .displayInline, children: items)
    return m
}

override func viewDidLoad() {
    super.viewDidLoad()
    button.menu = generateMenu(max: 10)
    button.showsMenuAsPrimaryAction = true
}

找到 UIBarButtonItem 案例的解决方案。我的解决方案基于 Jordan H 解决方案,但我遇到了一个错误 - 我的菜单更新方法 regenerateContextMenu() 并没有在每次出现菜单时被调用,而且我得到的是不相关的数据在菜单中。所以我稍微更改了代码:

private lazy var threePointBttn: UIButton = {
    [=10=].setImage(UIImage(systemName: "ellipsis"), for: .normal)
    // pay attention on UIControl.Event in next line
    [=10=].addTarget(self, action: #selector(regenerateContextMenu), for: .menuActionTriggered)
    [=10=].showsMenuAsPrimaryAction = true
    return [=10=]
}(UIButton(type: .system))


override func viewDidLoad() {
    super.viewDidLoad()
    threePointBttn.menu = createContextMenu()
    navigationItem.rightBarButtonItem = UIBarButtonItem(customView: threePointBttn)
}

private func createContextMenu() -> UIMenu {
    let action1 = UIAction(title:...
    // ...
    return UIMenu(title: "Some title", children: [action1, action2...])
}

@objc private func regenerateContextMenu() {
    threePointBttn.menu = createContextMenu()
}

在 iOS 14.7.1

上测试