YPNavigationBarTransition 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
YPNavigationBarTransition 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
YPNavigationBarTransition 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 MIT
开发语言 Objective-C
操作系统 iOS
软件类型 开源软件
开源组织
地区 不详
投 递 者 罗奇奇
适用人群 未知
收录时间 2021-11-30

软件简介

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 协议。
展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论

点击引领话题📣
暂无内容
发表了博客
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
发表了问答
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
暂无内容
0 评论
0 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部