UINavigationController 导航控制器
概念
- UINavigationController 继承于 UIViewController
- 包含:viewcontrollers、NavigationBar、Toolbar
- 导航控制器是一个堆栈结构,只是其中管理的对象是controller,通过push与pop进行controller的切换,UINavigationController是将这些控件(UINavigationBar,UINavigationItem和UIToolBar)和UIViewController紧密的结合了起来
总结:
NavigationController管理的东西:
- NavigationController管理多个Controller
- NavigationController管理着NavigationBar(通过
navigationController. navigationBar
方式可以调用)
NavigationBar管理多个NavigationItem,和NavigationController一样都是用push和pop的方式推进推出各自管理的东西NavigationItem包含多个UIBarButtonItem - NavigationController管理着ToolBar,通过
navigationController.toolbar
方式调用
控制器管理的东西
每个界面的Controller管理一个它界面的NavigationItem(通过controller. navigationItem
方式可以调用)
属性
1、获取栈顶的controller
@property(nullable, nonatomic,readonly,strong) UIViewController *topViewController;
2、获取当前界面显示的controller
@property(nullable, nonatomic,readonly,strong) UIViewController *visibleViewController;
3、 给导航控制器设置controller
@property(nonatomic,copy) NSArray<__kindof UIViewController *> *viewControllers;
例子: //将上面的这5个控制器添加到控制器数组中
self.viewControllers = @[navHall, navArena, navDiscovery, navHistory, navMyLottery];
4、设置隐藏导航栏
@property(nonatomic,getter=isNavigationBarHidden) BOOL navigationBarHidden;
5、 获取导航栏
@property(nonatomic,readonly) UINavigationBar *navigationBar;
6、是否隐藏底部工具条(默认隐藏)
@property(nonatomic,getter=isToolbarHidden) BOOL toolbarHidden;
7、获取底部工具条
@property(null_resettable,nonatomic,readonly) UIToolbar *toolbar;
8、获取导航中的返回手势对象(iOS7之后,在导航中右划会进行pop操作,设置这个的enable可以控制设置手势是否失效)
@property(nullable, nonatomic, readonly) UIGestureRecognizer *interactivePopGestureRecognizer;
9、获取滑动隐藏导航栏的手势
@property (nonatomic, readonly, strong) UIPanGestureRecognizer *barHideOnSwipeGestureRecognizer;
10、屏幕滑动的时候是否隐藏导航栏,常用于tableView,上滑隐藏导航栏,下滑显示,带动画效果
@property (nonatomic, readwrite, assign) BOOL hidesBarsOnSwipe;
11、 弹出键盘的时候是否隐藏导航栏
@property (nonatomic, readwrite, assign) BOOL hidesBarsWhenKeyboardAppears;
12、设置横屏的时候隐藏导航栏
@property (nonatomic, readwrite, assign) BOOL hidesBarsWhenVerticallyCompact;
13、敲击屏幕可以隐藏与显示导航栏
@property (nonatomic, readwrite, assign) BOOL hidesBarsOnTap;
14、获取敲击屏幕的手势
@property (nonatomic, readonly, assign) UITapGestureRecognizer *barHideOnTapGestureRecognizer;
15、导航控制器代理
@property(nullable, nonatomic, weak) id<UINavigationControllerDelegate> delegate;
16、当一个controller被添加到导航中后,系统会为它分配一些属性
(1)当前controller对应的导航项
@property(nonatomic,readonly,strong) UINavigationItem *navigationItem;
(2)push的时候隐藏底部栏,如push后隐藏tabbar
@property(nonatomic) BOOL hidesBottomBarWhenPushed;
(3)获取管理它的导航控制器
@property(nullable, nonatomic,readonly,strong) UINavigationController *navigationController;
方法
1、创建导航控制器的两种方法
(1)通过一个自定义的导航栏和工具栏创建导航控制器
- (instancetype)initWithNavigationBarClass:(nullable Class)navigationBarClass toolbarClass:(nullable Class)toolbarClass;
(2)使用系统默认的导航栏和工具栏,创建一个导航控制器同时设置一个根视图控制器
- (instancetype)initWithRootViewController:(UIViewController *)rootViewController;
2、设置管理的视图控制器
- (void)setViewControllers:(NSArray<UIViewController *> *)viewControllers animated:(BOOL)animated;
3、管理视图控制器操作
(1)压入新的视图控制器
- (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated;
这个方法是为了iOS方法的命名统一,在导航中,其作用和push一样
- (void)showViewController:(UIViewController *)vc sender:(nullable id)sender;
例子:设置隐藏底部TabBar
可以给所有控制器设置一个父类,重写该方法。继承该父类的控制器调用此方法都可以隐藏push来的控制器底部的TabBar
- (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated {
// 这里的参数viewController就是即将被push进来的控制器
viewController.hidesBottomBarWhenPushed = YES;
[super pushViewController:viewController animated:animated];
}
(2)弹出一个视图控制器 返回的是pop的controller
- (nullable UIViewController *)popViewControllerAnimated:(BOOL)animated;
(3)弹出到某个视图控制器 返回所有pop的controller
- (nullable NSArray<__kindof UIViewController *> *)popToViewController:(UIViewController *)viewController animated:(BOOL)animated;
(4)直接pop到根视图控制器,返回所有被pop的controller
- (nullable NSArray<__kindof UIViewController *> *)popToRootViewControllerAnimated:(BOOL)animated;
4、设置隐藏导航栏
- (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated;
5、是否隐藏底部工具条(默认隐藏)
- (void)setToolbarHidden:(BOOL)hidden animated:(BOOL)animated;
6、代理方法:
(1)视图将要展示时调用的方法
- (void)navigationController:(UINavigationController *)navigationController willShowViewController:(UIViewController *)viewController animated:(BOOL)animated;
(2)视图已经展示时调用的方法
- (void)navigationController:(UINavigationController *)navigationController didShowViewController:(UIViewController *)viewController animated:(BOOL)animated;
(3)设置导航控制器支持的设备方向
- (UIInterfaceOrientationMask)navigationControllerSupportedInterfaceOrientations:(UINavigationController *)navigationController;
(4)设置导航控制器的首选设备方向
- (UIInterfaceOrientation)navigationControllerPreferredInterfaceOrientationForPresentation:(UINavigationController *)navigationController;
(5)下面两个方法可以设置导航的转场动画
- (nullable id <UIViewControllerInteractiveTransitioning>)navigationController:(UINavigationController *)navigationController interactionControllerForAnimationController:(id <UIViewControllerAnimatedTransitioning>) animationController;
- (nullable id <UIViewControllerAnimatedTransitioning>)navigationController:(UINavigationController *)navigationController animationControllerForOperation:(UINavigationControllerOperation)operation fromViewController:(UIViewController *)fromVC toViewController:(UIViewController *)toVC ;