Latest 2.4.2
Homepage https://github.com/amisare/NNNavigationBar
License MIT
Platforms ios 8.0, requires ARC
Authors

GitHub release
CocoaPods
CocoaPods
GitHub license

本库用于实现UINavigationBar背景渐变过渡动画。

效果

ColorTransition
ImageTransition

介绍

NNNavigationBar是实现导航条背景渐变过渡动画的轻量级代码库。

实现

  • 代码库通过Category/Method Swizzling方式hook UINavigationBar的方法调用,实现导航条背景渐变过渡动画。

轻量

  • 仅对UINavigationBar进行了Method Swizzling方法混淆。不涉及其它类的方法混淆,如UIViewController、UINavigationController等。
  • 仅对UINavigationBar/UINavigationItem进行了必要的属性关联。

原理


                              UINavigationItem (category_xxx)
                                           |
                                           |
                                           V
                                           ①  
                                     add [.nn_xxx]
                                           |                         UIViewController
                                           |  ------------------->  [.navigationItem]
                                                                             |
                                                                             |
                                                                             V
                                                                             ② 
                                                               set vcn.navigationItem.nn_xxx
                                                                             |
                                                                             |
                                                                             |
                                 UINavigationController                      V
                                       vc stack                              ③            
                                 |        vcn        | <----- navigationController push/pop vcn
                                 |        ...        |                       |
                                 |        vc1        |                       |
                                 |        vc0        |                       |          
                                                                             |
     UINavigationBar                                                         |
-----------------------                                                      |
| <——    title        |                                                      |
-----------------------                                                      |
           |                                                                 |
           |                     UINavigationBar.Items                       V
           |        ④-②              item stack                           ④-①
           |<--- update Bar --- | vcn.navigationItem | <--- navigationBar push/pop vcn.navigationItem
           |          |         |        ...         |                       |
           |          |         | vc2.navigationItem |                       |
           |          |         | vc1.navigationItem |                       |
           |          |         | vc0.navigationItem |                       |
           |          |                                                      |
           |          |                        ④-③                          |
           |          |--------------------->  hook  <-----------------------|
           |                                    |
           |                                    |
           |                                    |
           |             ⑤                     |
           |<--- update Bar [.nn_xx] -----------|
  1. 使用runtime在UINavigationItem的Category中添加属性[.nn_xx]。
  2. 每个UIViewController中都拥有一个UINavigationItem属性navigationItem,在UIViewController中修改navigationItem对象的属性[.nn_xx]。
  3. 在UINavigationController push/pop UIViewController时,会将UIViewController的navigationItem对象 push/pop 给UINavigationBar。
  4. 通过Method Swizzling方式hook UINavigationBar方法调用,获得对应方法的调用时机。
  5. 在合适的时刻,UINavigationBar取得navigationItem对象中的属性[.nn_xx],更新UINavigationBar状态(本代码库实现了背景的平滑渐变过渡)。

使用

  1. 导入头文件
#import "NNNavigationBar.h"
  1. 颜色渐变过渡
- (void)viewDidLoad {
    [super viewDidLoad];
    // 去除系统背景
    [self.navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
    [self.navigationController.navigationBar setShadowImage:[UIImage new]];
    // 显示自定义背景
    self.navigationController.navigationBar.nn_backgroundViewHidden = false;
    // 设置背景颜色
    self.navigationItem.nn_backgroundColor = [UIColor orangeColor];
}
  1. 图片渐变过渡
- (void)viewDidLoad {
    [super viewDidLoad];
    // 去除系统背景
    [self.navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
    [self.navigationController.navigationBar setShadowImage:[UIImage new]];
    // 显示自定义背景
    self.navigationController.navigationBar.nn_backgroundViewHidden = false;
    // 设置背景图片
    self.navigationItem.nn_backgroundImage = [UIImage imageNamed:xx_image];
}
  1. 更多使用,详见demo

安装

CocoaPods

安装最新版的 CocoaPods:

$ gem install cocoapods

podfile 中添加:

pod 'NNNavigationBar', '~> 2.4.2'

然后在终端执行:

$ pod install

如安装失败,提示:

[!] Unable to find a specification for `NNNavigationBar`

尝试使用命令:

pod install --repo-update

系统要求

  • iOS 8.0+

许可证

NNNavigationBar 是基于 MIT 许可证下发布的,详情参见 LICENSE。

Latest podspec

{
    "name": "NNNavigationBar",
    "version": "2.4.2",
    "summary": "NNNavigationBar: make UINavigationBar background transition smoothly.",
    "description": "NNNavigationBar is A library that makes the UINavigationBar background to smoothly transition between different colors or images.",
    "homepage": "https://github.com/amisare/NNNavigationBar",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Haijun Gu": "[email protected]"
    },
    "social_media_url": "http://www.jianshu.com/users/9df9f28ff266/latest_articles",
    "source": {
        "git": "https://github.com/amisare/NNNavigationBar.git",
        "tag": "2.4.2"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "source_files": "NNNavigationBar/*.{h,m}",
    "public_header_files": "NNNavigationBar/NNNavigationBar.h",
    "subspecs": [
        {
            "name": "Core",
            "source_files": "NNNavigationBar/Core/*.{h,m,c}"
        },
        {
            "name": "Utils",
            "source_files": "NNNavigationBar/Utils/*.{h,m}"
        },
        {
            "name": "Background",
            "dependencies": {
                "NNNavigationBar/Core": [],
                "NNNavigationBar/Utils": []
            },
            "source_files": [
                "NNNavigationBar/Background/*.{h,m}",
                "NNNavigationBar/Background/**/*.{h,m}"
            ]
        },
        {
            "name": "TintColor",
            "dependencies": {
                "NNNavigationBar/Core": [],
                "NNNavigationBar/Utils": []
            },
            "source_files": [
                "NNNavigationBar/TintColor/*.{h,m}",
                "NNNavigationBar/TintColor/**/*.{h,m}"
            ]
        }
    ]
}

Pin It on Pinterest

Share This