iOS基于VIPER架构实现自定义导航栏时左右侧元素不显示
问题根因定位
代码运行时仅导航栏背景色生效、自定义左右元素完全不显示的现象,由两个叠加问题导致:
- 导航项挂载对象错误:UINavigationController本身的
navigationItem不会直接呈现在导航栏上。导航栏渲染的所有标题、左右按钮内容,永远来自当前导航栈中可见的顶层子视图控制器的navigationItem。当前代码把左右bar item全配置在了HomeNavController自己的navigationItem上,自然不会展示。而导航栏的背景色是直接配置在navigationBar实例上的,这类外观配置可以正常生效,和实际观察到的现象完全匹配。 - 自定义视图尺寸异常:就算修正了挂载对象的问题,代码中给自定义的label、button设置的frame是
.zero,没有尺寸计算逻辑的情况下,被UIBarButtonItem包裹的视图会被压缩成0尺寸,依然不会显示。
修复方案
核心调整逻辑
- 把原本设置在自身
navigationItem上的左右按钮,转移配置到当前可见的栈顶子控制器的navigationItem上 - 给自定义的按钮、label补全尺寸计算逻辑,确保控件有合理的展示大小
- 去掉无意义的重复配置:不需要每次
viewWillAppear都全量重建导航项,只要在导航栈顶控制器变化时做一次配置即可
修正后的参考代码
import UIKit class HomeNavController: UINavigationController { var tabTitle: String? init(rootViewController: UIViewController, title: String) { super.init(rootViewController: rootViewController) self.tabTitle = title configure() } required init?(coder aDecoder: NSCoder) { fatalError("init(coder:) has not been implemented") } override func viewDidLoad() { super.viewDidLoad() } // 监听栈顶控制器变化,自动给新的栈顶VC配置导航项,避免重复配置 override var visibleViewController: UIViewController? { didSet { configureNavigationItems() } } private func configure() { // 导航栏基础外观配置保留,这部分逻辑是正确的 navigationBar.isHidden = false navigationBar.isTranslucent = false navigationBar.tintColor = .white navigationBar.barTintColor = .primary configureNavigationItems() } private func configureNavigationItems() { // 拿到当前可见的栈顶控制器,配置它的导航项 guard let targetVC = visibleViewController else { return } // 左侧标题Label:自动计算尺寸 let nameLabel = UILabel() nameLabel.textColor = .white nameLabel.text = tabTitle nameLabel.sizeToFit() targetVC.navigationItem.leftBarButtonItem = UIBarButtonItem(customView: nameLabel) // 右侧聊天按钮:设置固定尺寸 let chatButton = UIButton(type: .system) chatButton.setImage(UIImage(named: "home-chat")?.withRenderingMode(.alwaysOriginal), for: .normal) chatButton.frame = CGRect(x: 0, y: 0, width: 24, height: 24) chatButton.imageEdgeInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -10) chatButton.addTarget(self, action: #selector(chatClicked), for: .touchUpInside) targetVC.navigationItem.rightBarButtonItem = UIBarButtonItem(customView: chatButton) } @objc func chatClicked() { print("Chat clicked") } }
补充注意点
- 后续导航栈里push其他子页面时,会自动触发栈顶变化回调,给新的栈顶VC同步配置这套通用导航项,不需要每个子模块单独重复写导航按钮逻辑,适配VIPER架构的模块化开发习惯。
- 如果后续需要给不同子页面定制不同的导航按钮,只需要在对应子VC的
viewDidLoad里修改自己的navigationItem属性即可,会自动覆盖这套通用配置。
内容的提问来源于stack exchange,提问作者sala7khaled
相关产品推荐
相关产品推荐

