×

YPNavigationBarTransition IOS导航栏框架

消耗积分:2 | 格式:zip | 大小:9.52 MB | 2022-06-23

陈敏

分享资料个

授权协议 MIT
开发语言 Objective-C
操作系统 iOS
软件类型 开源软件

软件简介

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 协议。
 

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉

评论(0)
发评论

下载排行榜

全部0条评论

快来发表一下你的评论吧 !