xifenglang / jknavigationcontroller

最高支持iOS10，已停止更新

iOS11正在适配中，2017.6.14

JKNavigationController

JKNavigationController 通过KVC调用私有API，已通过上架审核，目前已有2个上线项目使用JKNavigationController(2017.4.22)。

目录

• JKNavigationController简介
• JKNavigationController迭代记录
• JKNavigationController用法
  • 1.引入头文件
  • 2.将UINavigationController换成JKRootNavigationController
  • 3.为每个控制器VC的导航栏navigationBar定制颜色、透明度
  • 4.全屏侧滑返回手势
  • 5.修改navigationBar.tintColor
  • 6.navigationBar渐变位移效果
  • 7.拦截自定义返回按钮的点击事件
• 其他注意点

JKNavigationController简介

开始我只是想实现NavigationBar的渐变透明效果，但后来发现界面切换时会出现问题，对Push/Pop兼容性很差，折腾了一段时间也就放弃了，直到看到这篇文章《用Reveal分析网易云音乐的导航控制器切换效果》。然后就照着作者JNTian的思路，整合(搬运)了三个框架的代码，即Leo的LTNavigationBar、SunnyDog的FDFullscreenPopGesture和JNTian的JTNavigationController，最后实现了为每个控制器定制一个专属导航栏的效果，即每个customViewController都有一一对应的navigationController和navigationBar，可以为每个控制器定制导航栏的颜色。其次，自定义了侧滑返回手势，兼容Push/Pop动画。文章《用Reveal分析网易云音乐的导航控制器切换效果》中介绍的就是JNTian的JTNavigationController的实现思路，可以先看博客文章再研究源码，JNTian 介绍的很详细，很容易理解。

JKNavigationController迭代记录

• 2.1.2：解决tabBarController.viewControllers全部提前走viewDidLoad的BUG(1.0.1)，修改后界面显示才会走viewDidLoad
• 2.1.1：解决设置self.navigationItem.backBarButtonItem无效的BUG
• 2.1：增加返回按钮点击事件的拦截机制
• 2.0：兼容了iOS8、iOS9、iOS10，增加了对Push和Pop动画的兼容，并增加全屏侧滑返回手势
• 1.0：实现NavigationBar渐变效果，在iOS10上有兼容性BUG，并且没有适配Push/Pop切换动画。

JKNavigationController用法

1.引入头文件

	#import "JKNavigationController.h"

JKNavigationController.h包括了4个类文件：

"UINavigationBar+JKTransparentize.h" 修改navigationBar的背景色，可以实现渐变、位移效果 "JKRootNavigationController" 多样式导航控制器切换效果 "UIViewController+JKNavigationController.h" 全屏侧滑手势开关 "JKBackIndicatorButton.h" 自定义返回按钮

2.将入口处的UINavigationController换成JKRootNavigationController

	JKRootNavigationController * nav = [[JKRootNavigationController alloc] initWithRootViewController:homeVC];

3.为每个控制器VC的导航栏navigationBar定制颜色、透明度

全局设置多个控制器vc.navigationController.navigationBar的背景颜色，navigationBar.jk_barBackgroundColor属性具有全局效果，通过这个属性设置导航栏颜色，会影响后续Push的destinationVC导航栏的背景色。如果大部分界面的导航栏颜色一样，只要在第一个控制器设置navigationBar.jk_barBackgroundColor属性值就行。

	firstVC.navigationController.navigationBar.jk_barBackgroundColor = [UIColor orangeColor];

因为在JKInterLayerNavigationController类中重写了push方法，并且进行了下面的操作，起到了传递效果。

	destinationVC.navigationController.navigationBar.jk_barBackgroundColor = fromViewController.navigationController.navigationBar.jk_barBackgroundColor

设置当前控制器vc.navigationController.navigationBar的背景颜色，只会作用当前界面的navigationBar，此方法只能实现当前控制器导航栏navigationBar的渐变效果，不会影响其他控制器导航栏的颜色，也不会阻断navigationBar.jk_barBackgroundColor的传递效果，这一点需要注意。比如有Avc->Bvc->Cvc这种顺序结构的多个控制器，Avc设置了navigationBar.jk_barBackgroundColor，Bvc通过下面的方法定制颜色，但实际上Avc.navigationBar.jk_barBackgroundColor == Bvc.navigationBar.jk_barBackgroundColor == Cvc.navigationBar.jk_barBackgroundColor。

	[self.navigationController.navigationBar jk_setNavigationBarBackgroundColor:[UIColor orangeColor]];

4.全屏侧滑返回手势

全局控制 全屏侧滑返回手势的开关，会影响后续Push的destinationVC的jk_fullScreenPopGestrueEnabled，原因跟navigationBar.jk_barBackgroundColor一样，都是一层一层地传递赋值。

	self.jk_rootNavigationController.jk_fullScreenPopGestrueEnabled = YES;

控制单个控制器的全屏侧滑返回手势的开关,需要注意的是关闭全屏侧滑手势后，会使用系统原生的侧滑返回功能。

	self.jk_fullScreenPopGestrueEnabled = NO;

5.修改navigationBar.tintColor

因为有自定义返回按钮JKBackIndicatorButton，建议使用下面的方法修改tintColor，JKBackIndicatorButton 内部会重绘背景图片，如果只设置navigationBar.tintColor，将不会修改JKBackIndicatorButton 的颜色。

	[self.navigationController.navigationBar jk_setTintColor:[UIColor purpleColor]];

/// 不推荐
// self.navigationController.navigationBar.tintColor = [UIColor whiteColor];

6.navigationBar渐变位移效果

如果要实现知乎日报首页的效果，即NavigationBar的渐变偏移效果，则调用下面的代码。

	[navigationBar jk_setNavigationBarVerticalOffsetY:(CGFloat)offsetY]

/// 方法内部调用jk_setNavigationBarSubViewsAlpha:(CGFloat)alpha实现渐变色效果

7.拦截自定义返回按钮的点击事件

如果需要拦截返回按钮的点击事件，在控制器中实现JKNavigationControllerDelegate 协议方法即可。

- (BOOL)jk_navigationController:(JKRootNavigationController *)navigationController
                  shouldPopItem:(UINavigationItem *)item {
    do something...
    return yes or no
}
                  

其他注意点

需要注意一点，如果使用了StoryBoard或者XIB，并且在Push时隐藏TabBar，可能会出现留白或者闪烁。原因跟AutoLayout的更新时机有关，解决的思路是从TableView的Bottom约束入手，纯代码创建的控制器应该没问题。

jknavigationcontroller's Issues

tabbar的子控制器提前调用ViewDidLoad方法

一运行项目，tabbar的子控制器都会调用ViewDidLoad，一般习惯在这个方法加载控件，网络请求的方法等。这样好影响性能啊，有什么办法不让他触发，点了barItem才触发

[self setBackgroundImage:image forBarMetrics:UIBarMetricsDefault]; 调用导致屏幕的始点位置在(0,0)和(0,64)来回切换

我的导航栏默认是透明的此时屏幕的始点位置为(0，64)，滚动列表到一定位置后需要改为黑色。发现当跳转界面，再回到当前界面时，屏幕的始点位置变为 （0,0）了。

• (void)jk_setNavigationBarBackgroundColor:(UIColor *)backgroundColor {
  UIImage * image = JKGraphicsImageContextWithOptions(CGSizeMake(CGRectGetWidth(self.bounds), 64), ^{
  [backgroundColor setFill];
  UIRectFill(CGRectMake(0, 0, CGRectGetWidth(self.bounds), 64));
  });

  [self setBackgroundImage:image forBarMetrics:UIBarMetricsDefault];
  if ([self jk_systemBarContentView].backgroundColor != [UIColor clearColor]) {
  [self setShadowImage:[UIImage new]];
  [self jk_systemBarContentView].backgroundColor = [UIColor clearColor];
  [self jk_navigationBar].backgroundColor = [UIColor clearColor];
  }
  }

UINavigationBar+JKTransparentize 私有API

你好！这个实现里面哪些是调用的系统的私有API的呢？

关于iOS11 崩溃

您好！我使用xcode9打开您的工程点击右上角加号直接崩溃'[<UINavigationBar 0x7fe671776990> valueForUndefinedKey:]: this class is not key value coding-compliant for the key leftViews.'麻烦查看一下，谢谢

iOS 10 下那个view 的位置不对

• (void)jp_setNavigationBarBackgroundColor:(UIColor *)color{
  [[self.subviews firstObject] insertSubview:self.backgroundView atIndex:0];
  }
  添加这一句 才行

jk_setTintColor怎么隐藏导航栏返回文字？

jk_setTintColor只是设置颜色，我想隐藏返回栏文字，没看到你设置的方法。请指教

[rootNav setViewControllers:vcArray animated:YES]; 如何解决重置ViewControllers 过度动画时出现推进的控制器背景白色问题呢

想通过实现该方法来达到删除前一个控制器，但是过度的时候会出现卡顿问题

• (void)setViewControllers:(NSArray<UIViewController *> *)viewControllers animated:(BOOL)animated

不设置self.automaticallyAdjustsScrollViewInsets = NO; 如何解决push底部TabBar留空白的问题呢

想做到不设置self.automaticallyAdjustsScrollViewInsets = NO; 解决TabBar留空白问题。有新的进展吗？能解决这个问题就好了，否则感觉UI布局有很大的困扰哦。望大神出招

很棒

加油~