为什么为 UINavigationItem 设置自定义 backBarButtonItem 会导致出现双后退按钮?

Why does setting a custom backBarButtonItem for a UINavigationItem result in double back buttons?

我有一个非常简单的设置。具有根 UIViewController 的 UINavigationController,它使用 viewDidLoad 上的自定义后退按钮项修改其导航项。

    let backButton = UIBarButtonItem(image: backArrowImage,
                                     style: .plain,
                                     target: nil,
                                     action: nil)

    navigationItem.backBarButtonItem = backButton

我希望这能完全取代带有标题 默认后退箭头图标的系统后退按钮。

然而,当我将新的视图控制器推入堆栈时,导航栏会同时绘制新的自定义后退图标 系统后退图标。

这是我看到的:

这是我期望的样子:

您可以隐藏后退按钮

navigationItem.hidesBackButton = true

并使用 leftBarButtonItem 自定义 UIBarButtonItem

更新

import UIKit

final class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        navigationItem.hidesBackButton = true
        let backItem = UIBarButtonItem(image: backArrowImage, style: .plain, target: self, action: #selector(backButtonPressed))
        navigationItem.leftBarButtonItem = backItem
    }

    @objc func backButtonPressed() {
        navigationController?.popViewController(animated: true)
    }
}

解决方案是设置全局 UINavigationBar 外观。 显然这必须在应用启动时完成。

UINavigationBar.appearance().backIndicatorImage = backArrowImage
UINavigationBar.appearance().backIndicatorTransitionMaskImage = backArrowImage

通过这种方法,我们可以保留标题动画和一般的后退按钮行为,如果用 leftBarButtonItem 补充后退按钮则不会保留这些行为。