介绍
越来越多的应用程序在拥有全局导航栏样式的同时,也要求每个视图控制器自定义导航栏样式。
YDRootNavigationController 这个项目就是帮助开发者以高效的方式解决这个问题,开发者以简单的方式使用这个导航控制器,就像视图控制器独立设置状态栏风格一样,并且您可以为每个视图控制器提供单独的导航栏样式,包括原生返回手势、返回按钮、状态栏样式、标签栏显示和隐藏状态等等。可以查看这篇 Swift YDRootNavigationController的实现原理 文章进行深入了解。
概览
- 支持设置全局统一默认的导航栏样式(例如:导航栏背景颜色、底部分割线颜色、标题文字属性),同时支持每个视图控制器可以自定义导航栏样式
- 支持全局默认设置是否开启原生的返回手势,同时支持视图控制器自己默认设置和动态设置
- 支持全局默认设置是否开启全屏返回手势,同时支持视图控制器自己默认设置和动态设置
- 支持全局默认设置是否隐藏返回按钮,同时支持视图控制器自己默认设置和动态设置
- 支持全局默认设置是否隐藏导航栏,同时支持视图控制器自己默认设置和动态设置
- 支持全局默认设置是否隐藏标签栏,同时支持视图控制器自己默认设置和动态设置
- 支持设置状态栏样式和显示隐藏状态
- 支持定制返回按钮样式
- 支持自定义返回按钮
- 支持自定义返回按钮点击事件
- 支持
Interface Builder
安装
YDRootNavigationController 可通过 CocoaPods 获得。安装
只需将以下行添加到您的 Podfile 中:
pod 'YDRootNavigationController'
用法
一、全局默认样式配置
1.创建一个类用来实现YDAppAppearanceProtocol协议
class MyAppAppearance: YDAppAppearanceProtocol {
var navigationBarBackgroundColor: UIColor? { .white }
var navigationBarBackgroundImage: UIImage? { UIImage.gradient(colors: [UIColor.red, UIColor.blue], type: .leftToRight, size: CGSize(width: Screen.width, height: Screen.navigationBarHeight))?.addCorner(YDRectCorner(bottomRight: 20))}
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) }
}
这里用到的导航栏背景图片是用代码生成的,项目开发还是用UI切的图片比较节约系统资源,需要注意的是,如果同时设置导航栏背景颜色和背景图片,背景颜色将会被背景图片覆盖而失效
。
2.在AppDelegate中调用
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// 全局默认样式配置
MyAppAppearance().configure()
return true
}
}
二、视图控制器自定义样式配置
- 导航栏控制器设置为YDRootNavigationController或继承YDRootNavigationController的类
- 代码
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
self.window?.rootViewController = YDRootNavigationController()
return true
}
-
Interface Builder
设置
导航栏样式配置
导航栏标题文字属性
class ViewController: UIViewController {
override var navigationBarAppearence: YDNavigationBarAppearence {
YDNavigationBarAppearence(titleTextAttributes: [NSAttributedString.Key.foregroundColor: UIColor.randomColor, NSAttributedString.Key.font: UIFont.systemFont(ofSize: 20)])
}
}
导航栏背景颜色
class ViewController: UIViewController {
override var navigationBarAppearence: YDNavigationBarAppearence {
YDNavigationBarAppearence(backgroundColor: .randomColor)
}
}
导航栏背景图片
class ViewController: UIViewController {
override var navigationBarAppearence: YDNavigationBarAppearence { YDNavigationBarAppearence(backgroundImage: UIImage.gradient(colors: [UIColor.systemPink, UIColor.purple], type: .leftToRight, size: CGSize(width: Screen.width, height: Screen.navigationBarHeight))?.addCorner(YDRectCorner(bottomLeft: 20, bottomRight: 20))) }
}
这里用到的导航栏背景图片是用代码生成的,项目开发还是用UI切的图片比较节约系统资源,需要注意的是,如果同时设置导航栏背景颜色和背景图片,背景颜色将会被背景图片覆盖而失效
。
导航栏阴影颜色
class ViewController: UIViewController {
override var navigationBarAppearence: YDNavigationBarAppearence {
YDNavigationBarAppearence(shadowColor: .randomColor)
}
}