Awesome Open Source
Awesome Open Source

EasyNavigation Provided by anharismail

.

一款超级简单的导航条管理工具。完全自定义导航条。没有UINavigationBarUINavigationItem 这两个类。完全是对UIView的操作。 所有操作都能一行代码,操作之间完全独立,互不影响。

集成方法

手动导入

  1. 将工程中的EasyNavigation拖入工程中
  2. 包含'EasyNavigation.h的头文件
  3. 使用:
    1. 设置全局信息:EasyNavigationOptions *options = [EasyNavigationOptions shareInstance].titleColor = [UIColor blackColor];
    2. 设置全局信息自定义:EasyNavigationController *navVC = [[EasyNavigationController alloc]initWithRootViewController:[ViewController new]];
    3. 在当前控制器上添加一个标题:[self.navigationView setTitle:@"我是标题"];
    4. 在当前导航条右边添加一个按钮:[self.navigationView addRightButtonWithTitle:@"提交" clickCallBack:^(UIView *view) { NSLog(@"提交按钮被点击!");//notice:这个callback会强引用控制器,请用weakself. }];
    5. ......

cocoapods安装

  1. 在你的podfile文件中加入这句话 pod 'EasyNavigation','~>1.0'
  2. 包含头文件#import <EasyNavigation/EasyNavigation.h>
  3. 手动导入一样

使用详解

配置全局导航栏属性 这一步操作可以确保每一个控制器上头都有一个自定义的导航条。

  • (1) 包涵头文件
  • (2) (可省略)改变一些导航条的全局设置,但是如果省略的就会默认使用其单例里面的设置信息
  • (3) 用navigationcontroller包裹controller的时候,使用EasyNavigationController。如果是tabbar的话,则tabbar的每一个item都需要使用EasyNavigationController。如果使用的xib,则需要把xib中的导航控制器改成EasyNavigationController。
//(1)包涵头文件
#import "EasyNavigation.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    //(2)(可省略)改变一些导航条的全局设置,但是如果省略的就会默认使用其单例里面的设置信息
    EasyNavigationOptions *options = [EasyNavigationOptions shareInstance];
    options.titleColor = [UIColor blackColor];
    options.buttonTitleFont = [UIFont systemFontOfSize:18];
    options.navBackgroundImage = [UIImage imageNamed:@"nav_background_image.png"];
    
    //(3) 用navigationcontroller包裹controller的时候,使用EasyNavigationController。如果是tabbar的话,则tabbar的每一个item都需要使用EasyNavigationController。如果使用的xib,则需要把xib中的导航控制器改成EasyNavigationController。
    EasyNavigationController *navVC = [[EasyNavigationController alloc]initWithRootViewController:[ViewController new]];
    self.window.rootViewController  = navVC ;

    return YES;
}

【preview】

image

导航栏上的控件增删改操作

下面所有的操作,首先需要包含头文件 #import "EasyNavigation.h"

1,添加标题

  [self.navigationView setTitle:@"我是标题"];
  //需要改变标题上的文字
  [self.navigationView setTitle:@"我是改变后的标题"];
  //改变标题上面的属性
   self.navigationView.titleLabel.font = [UIFont systemFontOfSize:12] ;
   self.navigationView.titleLabel.textColor = [UIColor redColor];
  
  //需要添加一个titleview
  [self.navigationView addtitleView:customView];

2,添加按钮

//添加一个文字按钮 ,可以用全局变量记下这个rightButton。在你接下来的操作中使用这个按钮,
self.rightButton = [self.navigationView addRightButtonWithTitle:@"添加" clickCallBack:nil];
 //在某处使用这个按钮
 [self.rightButton setTitle:@"改变了" forState:UIControlStateNormal];

//添加一个带图片的按钮,如果这个按钮只有点击事件,可以这样写,更加简洁。
[self.navigationView addRightButtonWithImage:kImage(@"button_normal.png") hightImage:kImage(@"button_select.png") clickCallBack:^(UIView *view) {
        NSLog(@"点击了“图片按钮按钮”");
}];
//添加自定义按钮(clickCallback会对self强引用)
 kWeakSelf(self)
 UIButton *addButton  =[UIButton buttonWithType:UIButtonTypeCustom];
 [addButton setImage:kImage(@"nav_btn_back.png") forState:UIControlStateNormal];
 [addButton setTitle:@"返回" forState:UIControlStateNormal];
 [self.navigationView addLeftView:addButton clickCallback:^(UIView *view) {
       [weakself.navigationController popViewControllerAnimated:YES];
}];

3,添加/移除一个左右两边视图

添加/移除左右两边的视图后,都会重新布局两边的控件。

  //添加视图
    UIView *leftView = [[UIView alloc]initWithFrame:CGRectMake(0, 0, 40, 40)];
    [self.navigationView addLeftView:addButton clickCallback:^(UIView *view) {
           NSLog(@"click on leftView !");
    }];
  
  //移除视图 
  [self.navigationView removeLeftView:self.navigationView.leftButton];

4,添加一个view

  • view直接添加到导航栏上(不是两边控件)不会重新布局控件
  • 添加上view的frame不会受到导航条的约束。但是根据点击事件传递原理,它只会在导航条里面接受到事件。
  __block UIView *view = [[UIView alloc]initWithFrame:CGRectMake(100, -10, SCREEN_WIDTH-180, NAV_HEIGHT + 20)];
view.backgroundColor = [UIColor purpleColor];
[self.navigationView addSubview:view clickCallback:^(UIView *view) {
    [view removeFromSuperview];
}];

5,添加/移除导航条

  • 删除操作会把当前的导航条彻底重内存中删除。如果在以后还会使用建议使用self.navigationView.hidden = YES ;隐藏导航条
  • 添加操作会重新创建一个新导航条,需要自己往上面添加子控件。
  if (self.navigationView) {
      [self.navigationView removeFromSuperview];
      self.navigationView = nil ;
   }
if (!self.navigationView) {
     EasyNavigationView *nav = [[EasyNavigationView alloc]initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH , NAV_HEIGHT)];
     [self setNavigationView:nav];
     [self.view addSubview:nav];
 }

【preview】

image

透明度改变

1,设置导航条为透明背景

 [self.navigationView setNavigationBackgroundAlpha:0];     //当不想让导航条下面的细线变为透明 self.navigationView.lineView.alpha = 1 ;  

2,导航条颜色渐变

//self.tableView 为支持导航条渐变的scrollview,
//NAV_HEIGHT为开始渐变的位置,NAV_HEIGHT*4为结束渐变的位置。在其中间的移动会均匀变化
[self.navigationView navigationAlphaSlowChangeWithScrollow:self.tableView];

[self.navigationView navigationAlphaSlowChangeWithScrollow:self.tableView start:NAV_HEIGHT end:NAV_HEIGHT*4];

【preview】

image

导航条隐藏

1,无导航条

 可以移除,或者隐藏导航条

#if 1//以下两个2选1
    if (self.navigationView) {
        [self.navigationView removeFromSuperview];
        self.navigationView = nil ;
    }
#else
    self.navigationView.hidden = YES ;
#endif

2,导航条随scrollview滚动而慢慢隐藏

//self.tableView 为支持导航条渐变的scrollview,
//NAV_HEIGHT 为开始渐变self.tableView需要滚动的距离,也就是说,只有在self.tableView滚动NAV_HEIGHT后导航条才开始移动。
//0.5 为导航条向上滚动的速度。(它的值为:导航条滚动距离/self.tableView滚动距离)
//NO 为是否需要在statusBar下面停止。(statusBar颜色为导航条的背景)
 [self.navigationView navigationSmoothScroll:self.tableView start:NAV_HEIGHT speed:0.5 stopToStatusBar:NO];

3,导航条在scrollview滚动某个位置时以UIView动画隐藏

//self.tableView 为支持导航条渐变的scrollview,
//NAV_HEIGHT 为触发导航条隐藏的点。也就是当scrollview的contentOffset.y值操作这个数的时候,导航条就会隐藏
//NO 为是否需要在statusBar下面停止。(statusBar颜色为导航条的背景)
 [self.navigationView navigationAnimationScroll:self.tableView criticalPoint:NAV_HEIGHT stopToStatusBar:NO];

【图片】 image

导航条手势返回手势

1,系统返回手势

//是否禁止掉系统自带的侧滑返回手势,只会作用于当前控制器。无论在什么时候设置都。
 self.disableSlidingBackGesture = YES;

2,自定义拖动屏幕手势返回

设置自定义手势,不要关闭系统自带的侧滑手势。

   以下两个属性都可以随时变化

//是否开启 手势侧滑返回
 self.customBackGestureEnabel = YES ;
 //侧滑距离左边最大的距离,
 self.customBackGestureEdge = 100 ;

3,嵌套scrollview返回

【preview】

image

状态栏改变

默认状态栏为有状态栏,并且为黑色。每一次状态栏设置只会对当前控制器有效

//是否隐藏状态栏
 self.statusBarHidden = YES ;
 //设置当前状态栏的样式
 self.statusBarStyle =  UIStatusBarStyleDefault ; //UIStatusBarStyleLightContent 

【preview】

image

注意事项

这个库的原理是隐藏系统提供的导航栏,在ViewController加到导航栏控制器的桟上时加上一个自定的view作为导航栏。
加上的这个view用控制器的分类来保存。所以可以直接作为UIViewController的属性使用。
对侧滑控制是对导航控制器的interactivePopGestureRecognizer属性的操作。自定义侧滑是偷偷换掉这个属性的触发条件。
注意:由于是隐藏了系统导航栏。所以当控制器上第一个视图为scrollview的时候会向下偏移20。
需要用self.automaticallyAdjustsScrollViewInsets = NO  或者 scrollview.contentInset = UIEdgeInsetsMake(NAV_HEIGHT, 0, 0, 0)来调整视图位置。 
当控制器的第一个视图不是scrollview(或子类)的时候,需要让出导航栏高度的距离。
注意:由于隐藏了系统导航条,只要是用EasyNavigationController为控制器的管理工具时
系统提供的UINavigationBar 和 UINavigationItem 的属性就不能使用了。

联系作者

  • 若果在使用过程中发现问题,请提issue。我会及时解决。
  • 紧急问题可以通过邮箱:[email protected] 或微信联系我。
  • github
  • 喜欢,欢迎star~~~~

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
objective-c (10,924
navigation (262
ios11 (72
navigationbar (32