如何解决UIBarButtonItem配合setEditing使用时的访问与生效问题

算力阿峰

2026-9-27

UIBarButtonItem在setEditing中控制显隐的解决方案

问题根因

若直接在ViewController类作用域下初始化UIBarButtonItem常量，此时ViewController实例未完成初始化，你指定的target: self是无效的，所以按钮点击事件不会触发
若在viewDidLoad内部声明UIBarButtonItem，属于局部变量，作用域仅限viewDidLoad方法内部，外部的setEditing方法无法访问

实现步骤

在类作用域下声明两个可选类型的UIBarButtonItem存储属性

var addButton: UIBarButtonItem?
var playButton: UIBarButtonItem?

在viewDidLoad中完成按钮初始化，此时self已经完全初始化，target指向有效

override func viewDidLoad() {
    super.viewDidLoad()
    addButton = UIBarButtonItem(barButtonSystemItem: .add, target: self, action: #selector(addTapped))
    playButton = UIBarButtonItem(title: "Play", style: .plain, target: self, action: #selector(playTapped))
    navigationItem.rightBarButtonItems = [addButton!, playButton!]
}

重写setEditing方法，通过修改rightBarButtonItems数组控制按钮显隐

override func setEditing(_ editing: Bool, animated: Bool) {
    super.setEditing(editing, animated: animated)
    guard let addBtn = addButton, let playBtn = playButton else { return }
    if isEditing {
        // 编辑状态下仅保留add按钮，隐藏play按钮
        navigationItem.rightBarButtonItems = [addBtn]
    } else {
        // 非编辑状态展示两个按钮
        navigationItem.rightBarButtonItems = [addBtn, playBtn]
    }
}