https://github.com/forterli/flnavigationbar
一个用来统一管理导航栏转场以及当 push 或者 pop 的时候使动画效果更加顺滑的通用库，并且同时支持竖屏和横屏。能应对复杂的场景变化，又兼顾原生NavigationBar的使用习惯 https://juejin.im/post/5e8d8db36fb9a03c5d5c7f27
https://github.com/forterli/flnavigationbar
ios ios-app ios-swift navigationbar navigationbar-transition objective-c swift
Last synced: 8 months ago
JSON representation
一个用来统一管理导航栏转场以及当 push 或者 pop 的时候使动画效果更加顺滑的通用库，并且同时支持竖屏和横屏。能应对复杂的场景变化，又兼顾原生NavigationBar的使用习惯 https://juejin.im/post/5e8d8db36fb9a03c5d5c7f27
- Host: GitHub
- URL: https://github.com/forterli/flnavigationbar
- Owner: ForterLi
- License: mit
- Created: 2019-08-21T07:18:52.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-06-06T14:35:34.000Z (about 3 years ago)
- Last Synced: 2025-10-23T11:00:00.162Z (8 months ago)
- Topics: ios, ios-app, ios-swift, navigationbar, navigationbar-transition, objective-c, swift
- Language: Objective-C
- Homepage:
- Size: 89.8 KB
- Stars: 15
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FLNavigationBar
一个用来统一管理导航栏转场以及当 push 或者 pop 的时候使动画效果更加顺滑的通用库，并且同时支持竖屏和横屏。能应对复杂的场景变化，又兼顾原生NavigationBar的使用习惯
## 效果图
| Feature |Demo||
|---|---|---|
|Color -> Color|||
|Alone Bar -> Alone Bar|||
|Color -> Image Bar|||
|Hidden -> BlurEffectStyleLight|||
## 介绍
本库的设计理念是使用者只用关心当前 view controller 导航栏的背景样式
在当前 view controller的 UINavigationItem 中配置页面导航栏样式
## 使用说明
导航栏样式
```objc
typedef NS_ENUM(NSInteger, FLBarStyle) {
FLBarStyleNone = 0, // 公共样式
FLBarStyleDefault = 0xff, // 默认毛玻璃效果
FLBarStyleColor, // 颜色
FLBarStyleTransparent, // 透明
FLBarStyleHidden, // 隐藏
FLBarStyleTranslucent, // 毛玻璃效果可以修改样式
};
typedef NS_ENUM(NSInteger, FLBlurEffectStyle) {
FLBlurEffectStyleNone = 0,
FLBlurEffectStyleExtraLight,
FLBlurEffectStyleLight,
FLBlurEffectStyleDark,
FLBlurEffectStyleRegular API_AVAILABLE(ios(10.0)),
FLBlurEffectStyleProminent API_AVAILABLE(ios(10.0)),
};
```
推荐在navigation conreoller 中配置导航栏默认样式，如果不配置默认默认为 FLBarStyleDefault 半透明样式
``` swift
override func loadView() {
super.loadView()
self.barStyle = .color
self.barBackgroundColor = UIColor.white
self.barLineColor = UIColor.white
self.barStyleUpdate()
}
```
在每一个view controller 中配置单独配置每个页面的样式
```swift
// MARK: - Life Cycle
override func loadView() {
super.loadView()
self.navigationItem.yq_barStyle = .color
self.navigationItem.yq_barLineColor = .red
self.navigationItem.yq_barBackgroundColor = .yellow
}
```
每一个view controller单独配置页面独有的 NavigationBar
```swift
override func viewDidLoad() {
super.viewDidLoad()
addAloneBarNavigationBar()
}
override func viewDidLayoutSubviews() {
aloneBarViewDidLayoutSubviews()
}
```
```swift
// 当前Alone bar 与 UINavigationBar 一样，无法使用yq_barStyle、yq_barLineColor、yq_barBackgroundColor等扩展属性
self.alone_barNavigationBar
// 等价 self.navigationItem
self.alone_navigationItem
```
Custom NavigationController
```swift
class FLCustomNavigationController : UINavigationController,UINavigationControllerDelegate {
override func loadView() {
super.loadView()
self.delegate = self
}
func navigationController(_ navigationController: UINavigationController, willShow viewController: UIViewController, animated: Bool) {
self.startBar()
}
func navigationController(_ navigationController: UINavigationController, didShow viewController: UIViewController, animated: Bool) {
self.endBar(viewController)
}
}
```
## 安装
### CocoaPods
你可以用以下命令来安装最新版的 CocoaPods：
```bash
$ gem install cocoapods
```
在 `podfile` 中添加以下代码：
```ruby
pod 'FLNavigationBar'
```
然后在终端运行以下命令：
```bash
$ pod install
```
## 基本要求
- iOS 8.0+
## 许可证
FLNavigationBar 是基于 MIT 许可证下发布的，详情请参见 LICENSE。
## 更新
* ViewController 单独控制侧滑 全屏侧滑 pop
* 兼容 `Large Mode`
* 兼容 `prompt title`
* 适配 iOS 13 dark 模式
* 优化导航栏左右item间距的处理
## 联系方式
* forterli@163.com
* QQ群：1077108071