NavigationContainer

为每个控制器配置单独的导航栏

如果喜欢可以给个 Star，如果遇到问题请提交 Issues。

由于一开始就是为了项目重构而设计的，在尽量保证不入侵现有代码的情况下，无缝接入；所以针对性比较强，主要是针对下面的UI结构进行设计的，其他场景暂时未测试；当然了，暂时也不提供太多的定制化。

现有项目的UI层级结构：

UITabBarController
	│
	└── UINavigationController
	│		│
	│		└── UIViewController
	│
	└── UINavigationController
	│		│
	│		└── UIViewController
	│
	└── UINavigationController
	│		│
	│		└── UIViewController
	│
	└── UINavigationController
			│
			└── UIViewController

从上面可以看出项目根控制器就是一个 UITabBarController，管理着四大模块，每个模块的根控制器又是一个 UINavigationController，这也是一个很典型的结构了。

现在，我只需要将四大模块的根控制器 UINavigationController 替换成 XPRootNavigationController 就基本完成了接入工作；

为什么说基本呢，因为到目前为止虽然每个控制器都有了单独的导航栏，但是失去了原有经过定制的导航栏样式，接下来就需要恢复原来的导航栏样式，只需定义 kXPNavigationControllerClassName 这个宏即可：

#define kXPNavigationControllerClassName    @"YourNavigationController"

当然，如果你的返回图标也是需要定制的话，可以设置 xp_backIconImage 这个属性；

至此，整个接入工作就算完成了。

之前的导航栏怎么用，现在也照样还是怎么用，该用代码 push/pop 那你就照样 push/pop，Storyboard 里该怎么拖线跳转则还是照样直接拖线即可，你就当没这茬就行。这就是我要的效果。

调整后的项目结构

当使用该功能后，项目结构将会变成如下所示：

UITabBarController
    │
    └── XPRootNavigationController
    │    │
    │    └── XPWrappingViewController
    │        │
    │        └── UINavigationController
    │            │
    │            └── UIViewController
    │
    └── XPRootNavigationController
    │    │
    │    └── XPWrappingViewController
    │        │
    │        └── UINavigationController
    │            │
    │            └── UIViewController
    │
    └── XPRootNavigationController
    │    │
    │    └── XPWrappingViewController
    │        │
    │        └── UINavigationController
    │            │
    │            └── UIViewController
    │
    └── XPRootNavigationController
        │
        └── XPWrappingViewController
            │
            └── UINavigationController
                │
                └── UIViewController

当我们调用 pushViewController:animated: 方法时，会将传进来的 UIViewController 进行一层包装，使其能独享一个 UINavigationController，从而独享一个 UINavigationBar，这样就能将每个控制器的导航栏样式进行隔离，互不干扰。并且会将 push/pop 等相关操作转发给 XPRootNavigationController 处理。

宏定义

有两种方式可以定义 kXPNavigationControllerClassName 宏。

• 在 PCH 文件中进行定义

#define kXPNavigationControllerClassName    @"YourCustomNavigationController"

• 在 Build Settings -- Apple Clang - Preprocessing -- Preprocessor Macros Not Used In Precompiled Headers 中添加宏定义

kXPNavigationControllerClassName='@"YouCustomNavigationController"'

两种方式，你可以根据你项目实际情况进行设置。

关于第二种方式，可以参考Speeding up your Xcode Builds

特性

• 接入成本低，只需将你项目中的 UINavigationController 替换成 XPRootNavigationController 即可

• 轻松控制状态栏样式，控制器重写 -preferredStatusBarStyle 方法并返回所需样式即可

• 轻松隐藏刘海屏的 Home Indicator， 控制器重写 -prefersHomeIndicatorAutoHidden 并返回 YES 即可

• 轻松定制返回图标，每个控制器都可以拥有不一样的图标（只要你喜欢），内部将按照以下优先级从高到低来获取返回按钮图标：

  • 当前控制器的 xp_backIconImage 属性
  • -xp_navigationControllerClass 方法返回的导航栏控制器的 xp_backIconImage 属性
  • XPRootNavigationController 的 xp_backIconImage 属性
  • 如果以上的 xp_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 手势

• 支持导航栏渐变色功能

• 支持设置导航栏透明度

• 支持当导航栏透明时，触摸事件穿透

  • 当你通过 [self xp_setNavigationBarAlpha:0.0] 设置透明度时，默认为你启用事件穿透功能
  • 如果你想禁用事件穿透，请通过 [self xp_setNavigationBarAlpha:0.0 eventPenetrationWhenTransparent:NO] 来设置透明度
  • 事件穿透功能仅限于 XPGradientNavigationBar 这个类，如果你使用了其他导航栏则默认没有该功能（后续我应该也不会适配）

TODO

• 测试其他场景下的使用效果
• 考虑提供更多定制化，或许吧，毕竟本来就是本着简单易用的目标去做的，搞太复杂了就违背初衷了

GIF演示

与 FDFullscreenPopGesture 库一起使用

兼容 FDFullscreenPopGesture 库，你无需额外操作。

致谢

• RTRootNavigationController
• FDFullscreenPopGesture
  • 支持全局 pop 手势

感谢他们对开源社区做出的贡献。

协议

被许可在 MIT 协议下使用，查阅LICENSE文件来获得更多信息。