NNNavigationBar 实现导航条背景渐变过渡动画的轻量级框架
本库用于实现UINavigationBar背景渐变过渡动画。
bug 描述:导航右滑返回手势,概率性的导致返回以后页面的 rightBarButtonItem 的 tintColor 颜色变浅, bug 现象如下:
bug 代码:
- 在 viewDidLoad 中设置 rightBarButtonItem 会导致 bug 产生。bug 是概率性发生的,不易复现。
override func viewDidLoad() { super.viewDidLoad() // 在 viewDidLoad 中设置 rightBarButtonItem self.navigationItem.rightBarButtonItem = UIBarButtonItem.init(title: "Next", style: .plain, target: self, action: #selector(pushNextViewController)) self.view.backgroundColor = UIColor.white self.title = "Title" + " " + "\(self.page)" } @objc public func pushNextViewController() { let vc = self.nextViewController; vc.page = self.page + 1 self.navigationController?.pushViewController(vc, animated: true) }
bug 解决:
- 方式2:在 viewWillAppear 中设置 rightBarButtonItem 。
override func viewDidLoad() { super.viewDidLoad() // 将 rightBarButtonItem 设置移至 viewWillAppear // self.navigationItem.rightBarButtonItem = UIBarButtonItem.init(title: "Next", style: .plain, target: self, action: #selector(pushNextViewController)) self.view.backgroundColor = UIColor.white self.title = "Title" + " " + "\(self.page)" } override func viewWillAppear(_ animated: Bool) { super.viewWillAppear(animated) // 在 viewWillAppear 中设置 rightBarButtonItem self.navigationItem.rightBarButtonItem = UIBarButtonItem.init(title: "Next", style: .plain, target: self, action: #selector(pushNextViewController)) } @objc public func pushNextViewController() { let vc = self.nextViewController; vc.page = self.page + 1 self.navigationController?.pushViewController(vc, animated: true) }
- 方法2:issues12
bug 工程源码:UINavigationBarBug
NNNavigationBar是实现导航条背景渐变过渡动画的轻量级代码库。
UINavigationItem (category_xxx)
|
|
V
①
add [.nn_xxx]
| UIViewController
| -------------------> [.navigationItem]
|
|
V
②
set vcn.navigationItem.nn_xxx
|
|
|
UINavigationController V
vc stack ③
| vcn | <----- navigationController push/pop vcn
| ... | |
| vc1 | |
| vc0 | |
|
UINavigationBar |
----------------------- |
| <—— title | |
----------------------- |
| |
| UINavigationBar.Items V
| ④-② item stack ④-①
|<--- update Bar --- | vcn.navigationItem | <--- navigationBar push/pop vcn.navigationItem
| | | ... | |
| | | vc2.navigationItem | |
| | | vc1.navigationItem | |
| | | vc0.navigationItem | |
| | |
| | ④-③ |
| |---------------------> hook <-----------------------|
| |
| |
| |
| ⑤ |
|<--- update Bar [.nn_xx] -----------|
#import "NNNavigationBar.h"
- (void)viewDidLoad {
[super viewDidLoad];
// 去除系统背景
[self.navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
[self.navigationController.navigationBar setShadowImage:[UIImage new]];
// 显示自定义背景
self.navigationController.navigationBar.nn_backgroundViewHidden = false;
// 设置背景颜色
self.navigationItem.nn_backgroundColor = [UIColor orangeColor];
}
- (void)viewDidLoad {
[super viewDidLoad];
// 去除系统背景
[self.navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
[self.navigationController.navigationBar setShadowImage:[UIImage new]];
// 显示自定义背景
self.navigationController.navigationBar.nn_backgroundViewHidden = false;
// 设置背景图片
self.navigationItem.nn_backgroundImage = [UIImage imageNamed:xx_image];
}
安装最新版的 CocoaPods:
$ gem install cocoapods
在 podfile
中添加:
pod 'NNNavigationBar', '~> 2.7.3'
然后在终端执行:
$ pod install
如安装失败,提示:
[!] Unable to find a specification for `NNNavigationBar`
尝试使用命令:
pod install --repo-update
Carthage 是一个去中心化的依赖管理器,用于构建依赖和提供二进制 Framework 。
可以通过以下 Homebrew 命令安装 Carthage :
$ brew update
$ brew install carthage
通过 Carthage 将 NNNavigationBar 集成到 Xcode 项目中,需要在 Cartfile
中添加:
github "amisare/NNNavigationBar" ~> 2.7.3
执行 carthage
构建 Framework ,并将 NNNavigationBar.framework
添加到 Xcode 项目中。
NNNavigationBar 是基于 MIT 许可证下发布的,详情参见 LICENSE。