为每个控制器配置单独的导航栏
如果喜欢可以给个 Star
,如果遇到问题请提交 Issues。
由于一开始就是为了项目重构而设计的,在尽量保证不入侵现有代码的情况下,无缝接入;所以针对性比较强,主要是针对下面的UI结构进行设计的,其他场景暂时未测试;当然了,暂时也不提供太多的定制化。
现有项目的UI层级结构:
UITabBarController
│
└── UINavigationController
│ │
│ └── UIViewController
│
└── UINavigationController
│ │
│ └── UIViewController
│
└── UINavigationController
│ │
│ └── UIViewController
│
└── UINavigationController
│
└── UIViewController
从上面可以看出项目根控制器就是一个 UITabBarController
,管理着四大模块,每个模块的根控制器又是一个 UINavigationController
,这也是一个很典型的结构了。
现在,我只需要将四大模块的根控制器 UINavigationController
替换成 XPRootNavigationController
就基本完成了接入工作;
为什么说基本呢,因为到目前为止虽然每个控制器都有了单独的导航栏,但是失去了原有经过定制的导航栏样式,接下来就需要恢复原来的导航栏样式,只需定义 kXPNavigationControllerClassName
这个宏即可:
#define kXPNavigationControllerClassName @"YourNavigationController"
当然,如果你的返回图标也是需要定制的话,可以设置 backIconImage
这个属性;
至此,整个接入工作就算完成了。
之前的导航栏怎么用,现在也照样还是怎么用,该用代码 push/pop 那你就照样 push/pop,Storyboard 里该怎么拖线跳转则还是照样直接拖线即可,你就当没这茬就行。这就是我要的效果。
-
接入成本低,只需将你项目中的
UINavigationController
替换成XPRootNavigationController
即可 -
轻松控制状态栏样式,控制器重写
-preferredStatusBarStyle
方法并返回所需样式即可 -
轻松隐藏 iPhone X 的
Home Indicator
, 控制器重写-prefersHomeIndicatorAutoHidden
并返回YES
即可 -
轻松定制返回图标,每个控制器都可以拥有不一样的图标(只要你喜欢),内部将按照以下优先级从高到低来获取返回按钮图标:
- 当前控制器的
backIconImage
属性 -xp_navigationControllerClass
方法返回的导航栏控制器的backIconImage
属性XPRootNavigationController
的backIconImage
属性- 如果以上的
backIconImage
都为nil
,则XPRootNavigationController
内部会自动绘制一个返回图标
- 当前控制器的
-
兼容 UINavigationController 的 push/pop 操作,你无需调用额外接口,只需按照原有方式编写代码即可:
- [self.navigationController pushViewController:vc animated:YES];
- [self.navigationController popViewControllerAnimated:YES];
- [self.navigationController popToViewController:vc animated:YES];
- [self.navigationController popToRootViewControllerAnimated:YES];
- 同样也支持
Storyboard
中的拖线方式
-
轻松定制导航栏外观,你通过
kXPNavigationControllerClassName
这个宏设置了导航栏的默认样式,但是总有那么个别页面导航栏风格迥异;别怕,你只需在控制器中重写-xp_navigationControllerClass
方法并返回新的UINavigationController
或其子类 即可,你爱怎么定制就怎么定制 -
不需要导航栏?那直接隐藏即可
[self.navigationController setNavigationBarHidden:YES animated:NO];
- 如果在
viewDidLoad
中设置无效,那么你不妨在-viewWillAppear:
方法中试试
- 如果在
-
支持系统原生 pop 手势
- 测试其他场景下的使用效果
- 考虑提供更多定制化,或许吧,毕竟本来就是本着简单易用的目标去做的,搞太复杂了就违背初衷了
如果你的项目使用了该库,你会发现全局 pop 手势有时候正常,但是偶尔也会抽风似的,手指刚开始滑动,就自动返回上一页了;
请找到 XPContainerViewController
的初始化方法,自行添加以下代码:
- (instancetype)initWithViewController:(UIViewController *)viewController {
if (self = [super init]) {
...
// 解决`FDFullscreenPopGesture`全局pop引起的奇怪问题
navigationController.fd_fullscreenPopGestureRecognizer.enabled = NO;
navigationController.fd_interactivePopDisabled = YES;
navigationController.fd_viewControllerBasedNavigationBarAppearanceEnabled = NO;
self.fd_interactivePopDisabled = YES;
}
return self;
}
添加上述代码后就能愉快地使用全局 pop 手势了~~~
- RTRootNavigationController
- FDFullscreenPopGesture
- 支持全局 pop 手势
感谢他们对开源社区做出的贡献。
被许可在 MIT 协议下使用,查阅LICENSE
文件来获得更多信息。