iOS导航控制器——UINavigationController
一、概述
UINavigationController
用来管理视图控制器,在多视图控制器中常用。它以栈的形式管理视图控制器,管理视图控制器个数理论上不受限制(实际受内存限制),push
和pop
方法来弹入弹出控制器,最多只能显示一个视图控制器,那就是处于栈顶的视图控制器。
一般情况下,UINavigationController
最少管理一个控制器,即最少有一个根视图控制器或者叫做栈底视图控制器。当然也有例外,如果不给它添加视图控制器也不会报错,界面上也有视图,因为UINavigationController
继承自UIViewController
,也有自己的view,只不过默认情况下.view.backgroundColor
为nil,即透明的。
二、常用函数
- 使用
push
方法能将某个控制器压入栈
- (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated;
- 使用
setViewControllers
一次压入多个控制器vc1->vc2->vc3
,会显示最后的控制器vc3(处于栈顶),代码如下:
UINavigationController *nav = [[UINavigationController alloc] init];
window.rootViewController = nav;
// 创建3个测试控制器
UIViewController *vc1 = [[UIViewController alloc] init];
vc1.view.backgroundColor = [UIColor blueColor];
UIViewController *vc2 = [[UIViewController alloc] init];
vc2.view.backgroundColor = [UIColor redColor];
UIViewController *vc3 = [[UIViewController alloc] init];
vc3.view.backgroundColor = [UIColor greenColor];
// 最终会显示vc3
[nav setViewControllers:@[vc1,vc2,vc3] animated:YES];
- 使用pop方法可以移除栈顶控制器
当一个控制器被pop后,控制器内存就被释放了(会调用deinit/dealloc函数):
- (UIViewController *)popViewControllerAnimated:(BOOL)animated;
一层一层的返回不方便,可以直接回到指定的控制器VC_A(处与VC_A与栈顶之间的控制器全被释放),下面代码执行后,VC_A处于栈顶:
- (NSArray *)popToViewController:VC_A animated:(BOOL)animated;
回到根控制器(栈底控制器):
-(NSArray *)popToRootViewControllerAnimated:(BOOL)animated;
- 获取被管理的控制器
/// 当前管理的所有的控制器
@property(nonatomic,copy) NSArray<__kindof UIViewController *> *viewControllers;
/// 栈顶控制器
@property(nullable, nonatomic,readonly,strong) UIViewController *topViewController;
/// 当前可见的VC,可能是topViewController,也可能是当前topViewController present(modal)出来的VC,总而言之就是可见的VC
@property(nullable, nonatomic,readonly,strong) UIViewController *visibleViewController;
注意,topViewController与visibleViewController大部分情况一样,也有可能不同
三、导航条
UINavigationController
是做导航用的,具体的操作大部是由导航条来完成,导航条的使用就显得很重要。导航条的内容由控制器的navigationItem
属性决定。
1 navigationItem的属性
一般使用self.navigationItem.对应属性
来获取属性,或者设置属性。或者使用self.navigationController
获取到navigationController
,再通过navigationController
获取到想要设置的viewController
- 中间的标题文字
@property(nullable, nonatomic,copy) NSString *title;
- 中间标题视图
@property(nullable, nonatomic,strong) UIView *titleView;
- 导航栏附加解释说明,如果设置了此字段,导航栏会高出30个点显示此字段在
title
正上方
@property(nullable,nonatomic,copy) NSString *prompt;
prompt显示位置
- 自定义左上角的返回按钮
/// 直接设置
@property(nullable, nonatomic,strong) UIBarButtonItem *leftBarButtonItem;
大部分情况下,我们需要指定左边返回按钮距离左边框的距离,可以如下设定:
UIBarButtonItem *leftItem = [[UIBarButtonItem alloc] initWithImage:[UIImage imageNamed:@"gobackItem.png"] style:UIBarButtonItemStylePlain target:self action:@selector(backViewcontroller)];
UIBarButtonItem *fixedItem = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemFixedSpace target:nil action:nil];
// 设置边框距离,个人习惯设为-16,可以根据需要调节
fixedItem.width = -16;
self.navigationItem.leftBarButtonItems = @[fixedItem, leftItem];
下图为设置边框距离前后的差别:
没有设置边框距离
设置边框距离后
- 子导航条后退按钮,假设通过VC1
push
VC2,那么如果设置VC1.navigationItem.backBarButtonItem
就会显示在VC2的左上角返回按钮;如果再设置VC2.navigationItem.leftBarButtonItem
则会覆盖VC1的设置;如果VC1和VC2都没有设置,则会显示默认的backBarButtonItem
。
@property(nullable,nonatomic,strong) UIBarButtonItem *backBarButtonItem;
- 自定义右上角的按钮,或多个按钮
@property(nullable, nonatomic,strong) UIBarButtonItem *rightBarButtonItem;
/// 一次设置多个按钮
@property(nullable,nonatomic,copy) NSArray<UIBarButtonItem *> *rightBarButtonItems;
2 设置navigationItem的字体格式
// 字体大小19,颜色为白色
[nav.navigationBar setTitleTextAttributes:@{NSFontAttributeName:[UIFont systemFontOfSize:19],NSForegroundColorAttributeName:[UIColor whiteColor]}];
四、UIToolBar
UINavigationController
自带了一个工具栏,通过[self.navigationController setToolbarHidden:NO];
来显示工具栏,工具栏中的内容可以通过viewController
的toolbarItems
来设置,显示的顺序和设置的NSArray中存放的顺序一致,每一个UIBarButtonItem对象都可以设定点击事件,可以使用系统提供的很多常用风格的对象,也可以根据需求进行自定义,下面举例使用系统提供的样式。
// 1 显示工具条
[self.navigationController setToolbarHidden:NO];
// 2 创建四个UIBarButtonItem
UIBarButtonItem *itemOne = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemAdd target:nil action:nil];
UIBarButtonItem *itemTwo = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemSave target:nil action:nil];
UIBarButtonItem *itemThree = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemAction target:nil action:nil];
UIBarButtonItem *itemFour = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemSearch target:nil action:nil];
// 间隙
UIBarButtonItem *flexibleItem = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemFlexibleSpace target:nil action:nil];
// 3 添加到toolbarItems
vc.toolbarItems = @[itemOne,flexibleItem,itemTwo,flexibleItem,itemThree,flexibleItem,itemFour];
效果如下:
另外,UIToolBar使用的比较少,大部分情况下而是使用另一个导航控制器UITabBarController
五 UINavigationBar、UINavigationItem、UIToolbar与UIBarButtonItem四者关系
-
NavigaitonBar
是导航栏,位于屏幕的上方,管理整个NavigationController
的navigationItem
,它类似navigationcontroller
一样提供了一个栈来管理UINavigationItem
,在编程时,一般只设置每个控制器的navigationItem属性 - 一个导航控制器管理多个视图控制器(多个视图控制器共享一个导航控制器),而一个导航控制器只有一个
UINavigationBar
,被管理的多个视图控制器共享这一个UINavigationBar
,只要一个视图控制器改变了UINavigationBar
的属性则影响是全局的。每个视图控制器都会有属于自己的UINavigationItem
,系统会以懒加载的方式创建一个UINavigationItem
显示在UINavigationBar
中,改变UINavigationItem
只会在当前控制器起作用,不会影响其它控制器。 -
Toolbar
显示在屏幕底部,是导航控制器的工具栏,一个导航控制器只有一个,在任何被管理的视图控制器地方改变则会都改变。可以一次性添加多个UIBarButtonItem或按钮(包装成UIBarButtonItem后添加),有一个items数组属性。 -
UIBarButtonItem
是UINavigationItem
或者Toolbar
具体的一个按钮。
六、UINavigationControllerDelegate
有两个常用的方法
// 一般用于传递参数,或者做一些其它处理
- (void)navigationController:(UINavigationController *)navigationController willShowViewController:(UIViewController *)viewController animated:(BOOL)animated;
- (void)navigationController:(UINavigationController *)navigationController didShowViewController:(UIViewController *)viewController animated:(BOOL)animated;