YPNavigationBarTransition 是一个功能齐全的UINavigationBar框架，类似微信 UINavigationBar 效果的切换方案，支持任意透明半透明图片背景等等不同样式的 UINavigationBar 的切换，使过渡更自然！不需要调用任何UINavigationBarapi，YPNavigationBarConfigureStyle为视图控制器实现协议。

特征

支持不透明、全透明和半透明的导航栏
支持设置导航栏背景颜色
支持设置导航栏背景图片
可以动态调整导航栏样式
用 Objective-C 编写，具有完整的 Swift 互操作支持

不同颜色和透明度的 bar 之间的切换

图片背景的 navigation bar

动态调整 navigation bar 样式

依赖项

Xcode 9.0+
iOS 8.0+

使用 YPNavigationBarTransition

YPNavigationBarTransition 依靠 UINavigationControllerDelegate 的 willShow & didShow 驱动来实现自动管理 navigationBar 的切换。对于每一个对 navigationBar 的样式有自定义需求的 viewController，可以通过实现 YPNavigationBarConfigureStyle 协议来实现。每次 navigationController push 或者 pop viewController 的时候，YPNavigationBarTransition 通过对比当前 navigationBar 的样式和目标 viewController 指定的样式来判断是否需要添加 fake bar （用 UIToolbar）来模拟 navigation bar 的切换。

`YPNavigationBarConfigureStyle` 协议

typedef NS_ENUM(NSUInteger, YPNavigationBarConfigurations) {
    /*
     *  是否隐藏 navigation bar，默认是 show。
     */
    YPNavigationBarShow   = 0,
    YPNavigationBarHidden = 1,
    /*
     *  YPNavigationBarStyleLight = UIbarStyleDefault
     *  YPNavigationBarStyleBlack = UIbarStyleBlack
     *
     *  bar style 会影响 status bar 的样式，为 black 的时候 status bar 是白色，light 的时候是黑色。
     *  当没有自定义 background color 和 background image 的时候，navigation bar 的颜色也由 bar style 决定
     *  另外如果没有提供有效的 tintColor，YPNavigationBarTransition 将根据 bar style 自动设置 tintColor
     */
    YPNavigationBarStyleLight = 0 << 4,  // UIbarStyleDefault
    YPNavigationBarStyleBlack = 1 << 4,  // UIbarStyleBlack
    /*
     *  translucent = 半透明，transparent = 全透明，opaque = 不透明
     */
    YPNavigationBarBackgroundStyleTranslucent = 0 << 8,
    YPNavigationBarBackgroundStyleOpaque      = 1 << 8,
    YPNavigationBarBackgroundStyleTransparent = 2 << 8,
    /*
     *  使用颜色或者图片来配置 navigation bar 的 background image
     */
    YPNavigationBarBackgroundStyleNone  = 0 << 16,
    YPNavigationBarBackgroundStyleColor = 1 << 16,
    YPNavigationBarBackgroundStyleImage = 2 << 16,
    YPNavigationBarConfigurationsDefault = 0,
    /*
     *  是否显示 UINavigationBar 下方的横线，默认不显示
     *  在全透明 （Transparent） 的时候，将忽略 shadow image 的设置
     */
     YPNavigationBarShowShadowImage = 1 << 20,
};

- (YPNavigationBarConfigurations) yp_navigtionBarConfiguration;

[required] 返回 navigation bar 配置

- (UIColor *) yp_navigationBarTintColor;

[required] navigation bar tint color，影响 bar item 的颜色；如果返回 nil，bar style 是 YPNavigationBarStyleBlack 的话，将使用白色作为 tintColor， bar style 是 YPNavigationBarStyleLight 的话，将使用黑色作为 tintColor。

- (UIImage *) yp_navigationBackgroundImageWithIdentifier:(NSString **)identifier;

[optional] navigation bar background image,identifier作为 image 的 id 使用，同 id 的图片看作是同一张图片，在判断是否需要使用 fake bar 的时候需要用到。如果 bar configuration使用了 YPNavigationBarBackgroundStyleImage，这个方法一定要实现。

- (UIColor *) yp_navigationBackgroundColor;

[optional] navigation bar background color。如果 bar configuration 使用了 YPNavigationBarBackgroundStyleColor，这个方法一定要实现。

动态改变 NavigationBar 的样式

在合适的时机调用 UIViewController 的方法 yp_refreshNavigationBarStyle，即可将 UIViewController 实现的 YPNavigationBarConfigureStyle 当前样式同步到 navigation bar 上。参考 Example 里面的 YPGradientDemoViewController

最佳实践

默认 YPNavigationBarConfigureStyle 实现 自 2.0.2 版本开始，封装了 center 的 YPNavigationController 已内置在 framework 内，只需要给 YPNavigationController 加一个 Category 实现 YPNavigationBarConfigureStyle 协议即可。

NavigationItem Title 建议使用一个 UILabel 作为 navigationItem 的 titleView 来展现页面 title，这样可以让页面完全自己控制 title 的颜色、字体等等，并且还可以实现 subtitle。可以参考 Example 里面的 YPNavigationTitleLabel。

ScrollView 跳动问题 在转场过程中，navigationBar 的 translucent 属性可能发生了改变，然后导致了 scrollView 的 frame 和 contentInset 发生改变，页面展示内容位置变化。如果遇到这种情况，建议设置对应 controller 的 extendedLayoutIncludesOpaqueBars （IB 里面的 under opaque bar）为 YES，即可避开这个问题。

⚠️ 注意

不支持 iOS 11 新增的 navigationBar large title。
使用默认配置的页面，不用实现 YPNavigationBarConfigureStyle 协议。

YPNavigationBarTransitionIOS 导航栏框架

特征