UI基础 - UINavigationController：UINavigationBar | UIToolBar

■ UINavigationController

1. 导航控制器是专门管理具有层级关系内容的导航，以栈的方式管理所控制的视图控制器：至少要有一个被管理的视图控制器，这个被管理的视图控制器是导航控制器的根视图控制器

注：任何继承于 UIViewController 的控制器（包括多态）都可以作为导航控制器的根控制器

2. UINavigationController 是以栈的方式管理视图的，它所管理的视图被放进一个数组中。以下是通过导航控制器进入、返回视图的原理图

注：当底部视图控制器想要返回某一前面的视图控制器时，一定要从导航控制器中的子视图数组中获取

// 错误做法
SecondViewController *secVC = [SecondViewController new];
[self.navigationController popToViewController:secVC animated:YES];

// 正确打开方式
// 根据子控制器的下标，返回指定页面
[self.navigationController popToViewController:(SecondViewController *)[self.navigationController.viewControllers  objectAtIndex:1] animated:YES];
// 返回上一级页面呢
[self.navigationController popViewControllerAnimated:YES];
// 返回起始页面：下标是 0 的页面
[self.navigationController popToRootViewControllerAnimated:YES];

3. UINavigationController 的 view层 包含 3 个子视图：navigationBar、toolbar、contentView ，其中 contentView 不是属性，只是一种指代。我们可以通过遍历 view 的 subViews 来找到它

■ UINavigationBar

1. 导航条自 iOS 7 之后默认是透明的，iOS7 之前默认是不透明的：在透明情况下它会与 contentView 重合一部分区域；在不透明情况下 contentView 则会在它的下⾯

2. UINavigationBar 除了能定义⾃身的样式外，还管理了一组 UINavigationItem，它也是以栈的⽅式管理⼀组 Items，并提供有 push/pop 操作。UINavigationItem 属于 MVC 中的 M，封装了要显⽰在 UINavigationBar 上的数据：title、titleView、leftBarButtonItem 等

3. UINavigationItem 样式

4. 如何使用 UINavigationBar 

// - AppDelegate.m

#import "AppDelegate.h"
#import "ViewController.h"
@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];

    ViewController *firstVC  =[[ViewController alloc] init];
    firstVC.view.backgroundColor = [UIColor yellowColor];
    firstVC.title = @"UINavigationController";
    UINavigationController *rootVC = [[UINavigationController alloc] initWithRootViewController:firstVC];
    // 毛玻璃效果：默认 YES
    rootVC.navigationBar.translucent = NO;
    rootVC.navigationBar.hidden = NO;


    // 标题颜色、大小：如果设置背景图的话，会覆盖该效果
    [rootVC.navigationBar setTitleTextAttributes: [NSDictionary dictionaryWithObjectsAndKeys:
                                                   [UIColor yellowColor],
                                                   NSForegroundColorAttributeName,
                                                   [UIFont systemFontOfSize:18],
                                                   NSFontAttributeName,nil]];

    // iOS 13 之后，需使用 UINavigationBarAppearance
    if(@available(iOS 13.0,*)){

        UINavigationBarAppearance *navBarAppearance = [[UINavigationBarAppearance alloc] init];
        [navBarAppearance configureWithOpaqueBackground];
        // 背景颜色
        navBarAppearance.backgroundColor = [UIColor redColor];
        // 背景图片:图片尺寸和 navigationBar尺寸 不相同的话，会自动填充
        navBarAppearance.backgroundImage = [UIImage imageNamed:@"P150x20.png"];
        navBarAppearance.backgroundImage = [UIImage imageNamed:@"P375x64.png"];

        // 重设标题颜色、大小
        [navBarAppearance setTitleTextAttributes: [NSDictionary dictionaryWithObjectsAndKeys:
                                                   [UIColor greenColor],
                                                   NSForegroundColorAttributeName,
                                                   [UIFont systemFontOfSize:25],
                                                   NSFontAttributeName,nil]];

        rootVC.navigationBar.standardAppearance = navBarAppearance;
        rootVC.navigationBar.scrollEdgeAppearance = navBarAppearance;

    }
    // iOS 13 之前配置背景颜色、背景图片
    else{
        // 背景颜色
        rootVC.navigationBar.barTintColor = [UIColor redColor];
        // 背景图片：不会自动填充
        // 状况一：不同 navigationBar系统尺寸 保持一致的图片，效果展示会存在问题
        [rootVC.navigationBar setBackgroundImage:[UIImage imageNamed:@"P150x20.png"] forBarMetrics:UIBarMetricsDefault];
        // 状况二：同 navigationBar系统尺寸 保持一致的图片，效果展示不存在问题
        [rootVC.navigationBar setBackgroundImage:[UIImage imageNamed:@"P414x44.png"] forBarMetrics:UIBarMetricsDefault];
    }

    self.window.rootViewController = rootVC;
    return YES;
}

@end

运行效果

■ UIToolBar

1. UIToolBar 存在于导航栏控制器底部，且默认被隐藏！下面是 UIToolBar 的使用方式

// - AppDelegate.m

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // UIWidow
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];
    // 根视图控制器
    ViewController * vc = [[ViewController alloc] init];
    UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:vc];
    nav.navigationBar.translucent = NO;
    self.window.rootViewController = nav;
    return YES;
}

// - ViewController.m

#import "ViewController.h"
#import "AppDelegate.h"
@interface ViewController()
@property(nonatomic,strong)UIImageView *imageView;
@end

@implementation ViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    self.view.backgroundColor = [UIColor yellowColor];
    // 导航栏是否透明
    // 半透明/隐藏：根视图从原点开始显示，大小同屏幕一致
    // 不透明：    根视图从导航栏底部开始显示，高度 = 主屏幕高度 - 导航栏高度

    // 在 APPDelegate.m 文件中，导航栏无论毛玻璃效果的设置与否
    // 在该里打印根视图的 frame，其尺寸始终同屏幕大小保持一致
    // 模拟器是 8 plus
    NSLog(@"%@",NSStringFromCGRect(self.view.frame));//  {{0, 0}, {414, 736}}
    // 但是在 viewWillAppear:方法中 尺寸就会发生改变
    // 原因是在执行 viewDidLoad 时，根视图还未显示
    // 就是说该时根视图还没有跟导航控制器发生联系

    // 也就意味着我们在 viewDidLoad:方法中 配置 toolbar 是没有任何效果的
    // [self toolbarDemo];

    //----------------------------------
    // 导航栏的 左/右 标题
    self.navigationItem.leftBarButtonItem = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemReply target:self action:@selector(doClick:)];
    self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] initWithTitle:@"编辑" style:UIBarButtonItemStylePlain target:self action:@selector(doClick:)];
}

// Toolbar
- (void)viewWillAppear:(BOOL)animated{
    [super viewWillAppear:YES];
    NSLog(@"%@",NSStringFromCGRect(self.view.frame));
    // {{0, 64}, {414, 672}}
    [self toolbarDemo];

    NSLog(@"%@",NSStringFromCGRect(self.navigationController.toolbar.frame));
    // {{0, 687}, {414, 49}}
}

-(void)toolbarDemo{

    // 显示图片
    self.imageView = [[UIImageView alloc] initWithFrame:CGRectMake(10, 10, self.view.frame.size.width - 20, self.view.frame.size.height - 64-10)];
    self.imageView.backgroundColor = [UIColor whiteColor];
    self.imageView.image = [UIImage imageNamed:@"0.jpg"];
    [self.view addSubview:self.imageView];

    //--------------------- Toolbar -------------------

    // 显示时带有动画效果
    // [self.navigationController setToolbarHidden:NO animated:YES];
    // 无动画效果
    self.navigationController.toolbarHidden = NO;
    self.navigationController.toolbar.translucent = YES;
    self.navigationController.toolbar.backgroundColor = [UIColor greenColor];
    // 背景图片：尺寸要求同 navigationBar，这里图片尺寸 414*49
    [self.navigationController.toolbar setBackgroundImage:[UIImage imageNamed:@"P414x49.png"] forToolbarPosition:UIToolbarPositionAny barMetrics:UIBarMetricsDefault];
    
    [[UIToolbar appearance]
        setBackgroundImage: [UIImage imageNamed:@"P414x49.png"]
        forToolbarPosition: UIToolbarPositionAny
        barMetrics: UIBarMetricsDefault];
   
    // 左：取消按钮
    UIBarButtonItem *item1 = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemCancel target:self action:@selector(toolbarAction:)];
    item1.tintColor = [UIColor whiteColor];

    // 工具栏按钮要显示图片的话，需做以下处理
    UIImage *dealImage =[[self originImage:[UIImage imageNamed:@"toolItem.png"] scaleToSize:CGSizeMake(30, 30)] imageWithRenderingMode:UIImageRenderingModeAlwaysOriginal];
    UIBarButtonItem *item0 = [[UIBarButtonItem alloc] initWithImage:dealImage style:UIBarButtonItemStylePlain target:self action:@selector(toolbarAction:)];

    //右：显示 HOT
    UIBarButtonItem *item2 = [[UIBarButtonItem alloc] initWithTitle:@"HOT" style:UIBarButtonItemStylePlain target:self action:@selector(toolbarAction:)];
    item2.tag = 103;
    item2.tintColor = [UIColor whiteColor];

    // UIBarButtonSystemItemFlexibleSpace：自动确定宽度并均分
    UIBarButtonItem *spaceButtonItem = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemFlexibleSpace target:nil action:nil];

    // 添加 item
    self.toolbarItems = @[item1,spaceButtonItem,item0,spaceButtonItem,item2,];

}

// 随机显示图片
- (void)toolbarAction:(UIBarButtonItem *)bItem{

    if (bItem.tag == 103) {
        self.imageView.image =[UIImage imageNamed:[NSString stringWithFormat:@"%d.jpg",arc4random()%4+1]];
    }else{
        self.imageView.image = [UIImage imageNamed:@""];
    }
}

// 图片尺寸：会造成图片失真的问题
- (UIImage *)originImage:(UIImage*)image scaleToSize:(CGSize)size{
    UIGraphicsBeginImageContext(size);
    [image drawInRect:CGRectMake(0,0, size.width, size.height)];
    UIImage *scaledImage = UIGraphicsGetImageFromCurrentImageContext();
    UIGraphicsEndImageContext();
    return scaledImage;
}

// 如何查找 UINavigationController
- (void)doClick:(UIBarButtonItem*)barBT{

    if ([barBT isEqual:self.navigationItem.leftBarButtonItem]) {
        //方式一：利用 window
        NSLog(@"window：%@",self.view.window.rootViewController);
        //方式二：控制器的自带属性
        NSLog(@"self.navigationController：%@",self.navigationController);
    }else{
        //方式三：使用 UIApplication（需引入头文件 AppDelegate.h）
        NSLog(@"UIApplication：%@",((AppDelegate*)[UIApplication sharedApplication].delegate).window.rootViewController);
        //方式四：响应者链
        NSLog(@"响应者链：%@",[[[[[self.view nextResponder] nextResponder] nextResponder] nextResponder] nextResponder]);
    }
}

@end

运行效果

TODO：代码 60行 toolBar 设置背景图片无效