介绍

越来越多的应用程序在拥有全局导航栏样式的同时，也要求每个视图控制器自定义导航栏样式。

YDRootNavigationController 这个项目就是帮助开发者以高效的方式解决这个问题，开发者以简单的方式使用这个导航控制器，就像视图控制器独立设置状态栏风格一样，并且您可以为每个视图控制器提供单独的导航栏样式，包括原生返回手势、返回按钮、状态栏样式、标签栏显示和隐藏状态等等。可以查看这篇 Swift YDRootNavigationController的实现原理 文章进行深入了解。

返回手势与地图.gif

概览

• 支持设置全局统一默认的导航栏样式（例如：导航栏背景颜色、底部分割线颜色、标题文字属性），同时支持每个视图控制器可以自定义导航栏样式
• 支持全局默认设置是否开启原生的返回手势，同时支持视图控制器自己默认设置和动态设置
• 支持全局默认设置是否开启全屏返回手势，同时支持视图控制器自己默认设置和动态设置
• 支持全局默认设置是否隐藏返回按钮，同时支持视图控制器自己默认设置和动态设置
• 支持全局默认设置是否隐藏导航栏，同时支持视图控制器自己默认设置和动态设置
• 支持全局默认设置是否隐藏标签栏，同时支持视图控制器自己默认设置和动态设置
• 支持设置状态栏样式和显示隐藏状态
• 支持定制返回按钮样式
• 支持自定义返回按钮
• 支持自定义返回按钮点击事件
• 支持Interface Builder

安装

YDRootNavigationController 可通过 CocoaPods 获得。安装
只需将以下行添加到您的 Podfile 中：

pod 'YDRootNavigationController'

用法

一、全局默认样式配置

1.创建一个类用来实现YDAppAppearanceProtocol协议

class MyAppAppearance: YDAppAppearanceProtocol {
    var navigationBarBackgroundColor: UIColor? { .white }
    var navigationBarShadowColor: UIColor? { .red }
    var titleTextAttributes: [NSAttributedString.Key : Any]? { [NSAttributedString.Key.foregroundColor: UIColor.blue] }
    var backItemImage: UIImage? { UIImage(named: "nav_back_black_button") }
    var backItemImageInsets: UIEdgeInsets? { UIEdgeInsets(top: 0, left: -6, bottom: 0, r[图片上传中...(导航栏背景颜色.gif-384156-1711033391835-0)]
ight: 0) }
}

2.在AppDelegate中调用

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // 全局默认样式配置
        MyAppAppearance().configure()
        return true
    }
}

二、视图控制器自定义样式配置

1. 导航栏控制器设置为YDRootNavigationController或继承YDRootNavigationController的类

• 代码

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    self.window?.rootViewController = YDRootNavigationController()
    return true
}

• Interface Builder设置

IB设置YDRootNavigationController.gif

导航栏样式配置

导航栏标题文字属性

class ViewController: UIViewController {
    override var navigationBarAppearence: YDNavigationBarAppearence {
        YDNavigationBarAppearence(titleTextAttributes: [NSAttributedString.Key.foregroundColor: UIColor.randomColor, NSAttributedString.Key.font: UIFont.systemFont(ofSize: 20)])
    }
}

标题文字属性.gif

导航栏背景颜色

class ViewController: UIViewController {
    override var navigationBarAppearence: YDNavigationBarAppearence {
        YDNavigationBarAppearence(backgroundColor: .randomColor)
    }
}

导航栏背景颜色.gif

导航栏阴影颜色

class ViewController: UIViewController {
    override var navigationBarAppearence: YDNavigationBarAppearence {
        YDNavigationBarAppearence(shadowColor: .randomColor)
    }
}

导航栏阴影.gif