添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

Repository files navigation

iOS自定义导航栏 - 导航栏联动效果

GKNavigationBarViewController需要继承,侵入性较高,推荐使用 GKNavigationBar

另外Swift版本 GKNavigationBarSwift

现在大多数的APP都有导航栏联动效果,即滑动返回的时候导航栏也跟着一起返回,比如:网易新闻,网易云音乐,腾讯视频等等,于是通过查找一些资料及其他库的做法,自己也写了一个框架,可以让每一个控制器都拥有自己的导航栏,可以很方便的改变导航栏的样式等

iOS自定义导航栏-导航栏联动(一) , GKNavigationController

iOS自定义导航栏-导航栏联动(二) , GKNavigationBarViewController

感谢使用该库,如果在使用过程中遇到问题可查看issue或提交issue,或者进QQ群1047100313

状态栏问题

1、有时修改状态栏会闪动(从黑色变成白色等)或状态栏颜色显示异常(左边黑色右边白色等)

在UIViewController的init方法中修改gk_statusBarStyle即可
使用IQKeyboardManager滑动返回错乱问题

需要修改IQKeyBoardManager源码,将系统导航手势修改为自定义手势,如下

UIPanGestureRecognizer *gesture = [strongRootController.navigationController valueForKey:@"panGesture"];
if (gesture.state == UIGestureRecognizerStateBegan) {
    strongSelf.rootViewControllerWhilePopGestureRecognizerActive = strongRootController;
    strongSelf.topViewBeginOriginWhilePopGestureRecognizerActive = strongSelf.topViewBeginOrigin;
* 支持自定义导航栏样式(隐藏、透明等)
* 支持控制器开关返回手势
* 支持控制器开关全屏返回手势
* 支持控制器设置导航栏透明度,可实现渐变效果
* 完美解决UITableView,UIScrollView滑动手势冲突
* 可实现push,pop时控制器缩放效果(如:今日头条)
* 可实现左滑push一个控制器的效果(如:网易新闻)

Demo中部分截图如下

在AppDelegate的didFinishLaunchingWithOptions方法中配置导航栏的默认属性:
    [GKConfigure setupCustomConfigure:^(GKNavigationBarConfigure *configure) {
        // 导航栏背景色
        configure.backgroundColor = [UIColor whiteColor];
        // 导航栏标题颜色
        configure.titleColor = [UIColor blackColor];
        // 导航栏标题字体
        configure.titleFont = [UIFont systemFontOfSize:18.0f];
        // 导航栏返回按钮样式
        configure.backStyle = GKNavigationBarBackStyleBlack;
        // 导航栏itme左右间距
        configure.gk_navItemLeftSpace = 12.0f;
        configure.gk_navItemRightSpace = 12.0f;
  • 将基类控制器修改为GKNavigationBarViewController 可在每个控制器的viewDidLoad中单独设置导航栏的样式
  • - (void)viewDidLoad {
        [super viewDidLoad];
        // 设置导航栏样式
        self.gk_navTitle = @"Demo";
        self.gk_navTitleColor = [UIColor whiteColor];
        self.gk_navBackgroundColor = [UIColor redColor];
        self.gk_navShadowColor = [UIColor blackColor];
        self.gk_backStyle = GKNavigationBarBackStyleWhite;
        self.gk_navRightBarButtonItem = self.moreItem;
    
  • 今日头条的实现
  • UINavigationController作为根控制器,包含一个UITabBarController,UITabBarController中包含以GKNavigationBarViewController为父类的子类

    导航栏创建方式

    GKToutiaoViewController *toutiaoVC = [GKToutiaoViewController new];
    // 根控制器是导航控制器,需要缩放
    UINavigationController *nav = [UINavigationController rootVC:toutiaoVC translationScale:YES];
    
  • 网易云音乐的实现
  • UITabBarController作为根控制器,包含带导航栏的以GKNavigationBarViewController为父类的子类

  • 网易新闻的实现
  • UITabBarController作为根控制器,包含带导航栏的以GKNavigationBarViewController为父类的子类 其中导航栏开启左滑push手势,主要代码如下:

    // 导航栏开启左滑push
    UINavigationController *nav = [UINavigationController rootVC:vc translationScale:NO];
    nav.gk_openScrollLeftPush = YES;
    // 单个控制器中设置左滑push代理,并实现方法
    1. // 设置push的代理
    self.gk_pushDelegate = self;
    2. 实现代理方法
    - (void)pushToNextViewController {
        GKWYNewsCommentViewController *detailVC = [GKWYNewsCommentViewController new];
        detailVC.hidesBottomBarWhenPushed = YES;
        [self.navigationController pushViewController:detailVC animated:YES];
    
  • 部分属性介绍
  • UINavigationController

    /** 导航栏转场时是否缩放,此属性只能在初始化导航栏的时候有效,在其他地方设置会导致错乱 */
    @property (nonatomic, assign, readonly) BOOL gk_translationScale;
    /** 是否开启左滑push操作,默认是NO */
    @property (nonatomic, assign) BOOL gk_openScrollLeftPush;
    

    UIViewController

    /** 是否禁止当前控制器的滑动返回(包括全屏返回和边缘返回) */
    @property (nonatomic, assign) BOOL gk_interactivePopDisabled;
    /** 是否禁止当前控制器的全屏滑动返回 */
    @property (nonatomic, assign) BOOL gk_fullScreenPopDisabled;
    /** 全屏滑动时,滑动区域距离屏幕左边的最大位置,默认是0:表示全屏都可滑动 */
    @property (nonatomic, assign) CGFloat gk_popMaxAllowedDistanceToLeftEdge;
    /** 设置导航栏的透明度 */
    @property (nonatomic, assign) CGFloat gk_navBarAlpha;
    /** push代理 */
    @property (nonatomic, assign) id<GKViewControllerPushDelegate> gk_pushDelegate;
    

    GKNavigationBarViewController

    自定义导航条 @property (nonatomic, strong, readonly) UINavigationBar *gk_navigationBar; 自定义导航栏栏目 @property (nonatomic, strong, readonly) UINavigationItem *gk_navigationItem; #pragma mark - 额外的快速设置导航栏的属性 @property (nonatomic, strong) UIColor *gk_navBarTintColor; @property (nonatomic, strong) UIColor *gk_navBackgroundColor; @property (nonatomic, strong) UIImage *gk_navBackgroundImage; @property (nonatomic, strong) UIColor *gk_navTintColor; @property (nonatomic, strong) UIView *gk_navTitleView; @property (nonatomic, strong) UIColor *gk_navTitleColor; @property (nonatomic, strong) UIFont *gk_navTitleFont; @property (nonatomic, strong) UIBarButtonItem *gk_navLeftBarButtonItem; @property (nonatomic, strong) NSArray<UIBarButtonItem *> *gk_navLeftBarButtonItems; @property (nonatomic, strong) UIBarButtonItem *gk_navRightBarButtonItem; @property (nonatomic, strong) NSArray<UIBarButtonItem *> *gk_navRightBarButtonItems;

    Cocoapods(已支持)

    pod 'GKNavigationBarViewController'

    2021.05.20 -- 3.0.2 导航栏间距处理优化,修复添加子控制器后的问题
    2021.04.06 -- 3.0.1 增加协议,解决返回手势与其他手势冲突问题
    2021.02.25 -- 3.0.0 导航栏高度优化,支持放大模式及iPad
    
    2021.02.22 -- 2.8.0 返回拦截优化,可同时支持点击和手势返回,导航栏间距调整优化
    2020.12.26 -- 2.7.0 手势处理优化,返回拦截优化
    2020.12.02 -- 2.6.6 修复iPhone 12,iPhone 12 Pro机型调整导航栏间距不准确的bug
    2020.11.30 -- 2.6.5 修复安全区域判断bug,支持与系统导航平滑切换处理
    2020.11.26 -- 2.6.4 手势处理逻辑优化,修复某些情况下控制器不能释放的bug
    2020.10.23 -- 2.6.3 iOS14安全区域适配,内部方法修改
    2020.10.19 -- 2.6.2 修改对刘海屏的判断,适配iPhone 12系列手机
    2020.10.18 -- 2.6.1 增加自定义push或pop转场的代理
    2020.08.21 -- 2.5.8 修复导航栏间距调整无法屏蔽的bug
    2020.07.28 -- 2.5.7 增加导航栏间距调整对某些控制器的屏蔽
    2020.07.27 -- 2.5.6 修复方法交换可能带来的crash问题
    2020.07.22 -- 2.5.5 优化手势处理方法,增加属性可屏蔽某些控制器对手势处理的影响
    2020.07.16 -- 2.5.4 增加gk_backImage属性,可自定义返回按钮
    2020.06.30 -- 2.5.2 bug修复,屏蔽某些没有导航栏的控制器对导航栏间距调整的影响 
    2020.06.22 -- 2.5.1 修复导航栏间距属性修改到UIVIewController中
    2020.06.16 -- 2.5.0 修复设置导航栏间距失效的bug
    2020.04.07 -- 2.4.7 优化代码,修复已知问题
    2020.03.34 -- 2.4.5 修改crash
    2020.01.14 -- 2.4.4 修复设置某个导航栏间距后其他导航栏间距不准确问题
    2019.12.24 -- 2.4.2 修复默认返回按钮不显示问题,项目结构调整
    2019.12.22 -- 2.4.1 优化代码,解决改变状态栏颜色无效的bug
    2019.11.04 -- 2.4.0 优化部分代码及功能
    2019.10.17 -- 2.3.7 优化代码,删除弃用方法,增加对Carthage的支持
    2019.10.10 -- 2.3.6 优化带tabbar的控制器的push、pop动画,已知bug修复
    2019.8.2     -- 2.3.4 适配iOS13,优化导航栏左右item间距的处理
    2019.7.18   -- 2.3.3 修复滑动返回手势与其他手势冲突的bug
    2019.6.18   -- 2.3.2 优化导航栏item设置为nil时可能出现的问题
    2019.5.28   -- 2.3.0 优化导航栏分割线的处理及创建方式
    2019.5.24   -- 2.2.6 优化导航栏左右item间距的处理方法
    2019.5.5     -- 2.2.5 增加自定义缩放转场动画时的偏移量
    2019.4.21   -- 2.2.4 增加push、pop滑动过渡时的临界值
    2019.3.15   -- 2.2.3 增加禁止手势冲突处理属性,可对某个UISCrollView单独处理
    2019.3.5     -- 2.2.2 优化根控制器的gk_popDelegate功能失效问题
    2019.2.24   -- 2.2.1 增加gk_popDelegate,实现该协议原来的右滑返回操作将失效
    2019.1.17   -- 2.2.0 优化push和pop动画
    2019.1.11   -- 2.1.7 解决开启左滑push功能,在根控制器多次左右滑动后出现卡死的问题
    2018.12.2   -- 2.1.6 导航栏处理优化,可在viewDidLoad中使用gk_navLineHidden来隐藏分割线
    2018.11.29 -- 2.1.5 修复在控制器中设置gk_backStyle无效的问题,其他细节微调
    2018.10.28 -- 2.1.4 移除对UIVideoEditorController的控制
    2018.10.19 -- 2.1.3 修复设置透明导航栏在iOS10以前无效的问题
    2018.9.27   -- 2.1.1 全面适配iPhone X系列机型,修复bug
    2018.9.11   -- 2.1.0 解决根控制器开启左滑push无效的问题
    2018.9.10   -- 2.0.8 拆分左右间距设置属性,可分别设置导航栏左右间距
    2018.9.7     -- 2.0.6 发布,增加设置导航栏标题和隐藏分割线的属性
    2018.3.8     -- 2.0.1 发布,修复bug,控制器新增设置导航栏左右按钮间距的属性
    2018.3.5     -- 2.0.0 发布,修复bug,解决崩溃问题
    2017.10.11 -- 1.3.0 版本,   修复bug,解决手势冲突问题
    2017.9.20   -- 1.2.6 版本  适配iOS11,iPhone X
    2017.8.31   --
        1. 新增控制器旋转的方法,可以很好的控制单个控制器的旋转问题
        2. 新增获取当前显示的控制器的方法
    2017.8.30   --
        1. 优化设置导航栏背景色的方法
        2. 新增隐藏和显示导航栏底部分割线的方法
    2017.8.25   -- 新增控制器设置状态栏的方法,优化部分内容
    2017.8.23   -- 修复图片不显示的bug
    2017.8.18   -- 修复pod错误问题
    2017.7.14   -- 支持cocoapods
    2017.7.13   -- 框架实现完成,发布