Latest 1.0.5
Homepage https://github.com/chenliangloveyou/EasyNavigation
License MIT
Platforms ios 7.0
Authors

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

EasyNavigation
EasyNavigation
EasyNavigation
EasyNavigation
EasyNavigation

集成方法

手动导入

  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. }];
      1. ……

cocoapods安装

  1. 在你的podfile文件中加入这句话 pod 'EasyNavigation','~>1.0.1'
  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 的属性就不能使用了。

期望

  1. 如果在使用过程中遇到任务问题,或者发现使用不够恰当。希望能联系我 email: [email protected] qq:455158249
  2. 如果您在使用过程中发现bug,希望能在issues中提出。我会持续改进这个库的。
  3. 如果喜欢,希望能给个star,你们的start是我优化这个库的动力。

Latest podspec

{
    "name": "EasyNavigation",
    "version": "1.0.5",
    "summary": "u4e00u6b3eu8d85u7ea7u7b80u5355u7684u5bfcu822au6761u7ba1u7406u5de5u5177,u6ca1u6709UINavigationBaru548cUINavigationItemu8fd9u4e24u4e2au7c7bu3002u5b8cu5168u662fu5bf9UIViewu7684u64cdu4f5cu3002 u6240u6709u64cdu4f5cu90fdu80fdu4e00u884cu4ee3u7801uff0cu64cdu4f5cu4e4bu95f4u5b8cu5168u72ecu7acbuff0cu4e92u4e0du5f71u54cdu3002",
    "description": "u4e00u6b3eu8d85u7ea7u7b80u5355u7684u5bfcu822au6761u7ba1u7406u5de5u5177u3002u5b8cu5168u81eau5b9au4e49u5bfcu822au6761u3002u6ca1u6709UINavigationBaru548cUINavigationItemu8fd9u4e24u4e2au7c7bu3002u5b8cu5168u662fu5bf9UIViewu7684u64cdu4f5cu3002 u6240u6709u64cdu4f5cu90fdu80fdu4e00u884cu4ee3u7801uff0cu64cdu4f5cu4e4bu95f4u5b8cu5168u72ecu7acbuff0cu4e92u4e0du5f71u54cdu3002u96c6u6210u7b80u5355uff0cu4f7fu7528u7b80u5355u3002",
    "homepage": "https://github.com/chenliangloveyou/EasyNavigation",
    "license": "MIT",
    "authors": {
        "chenliangloveyou": "[email protected]"
    },
    "source": {
        "git": "https://github.com/chenliangloveyou/EasyNavigation.git",
        "commit": "daf7cf596e9354d6ac9d632562186bd27bf7133f"
    },
    "source_files": "EasyNavigation/*.{h,m}",
    "resources": "EasyNavigation/EasyNavButton.bundle",
    "platforms": {
        "ios": "7.0"
    }
}

Pin It on Pinterest

Share This