EachNavigationBar
示例
要运行示例项目,请克隆仓库,然后从 Example 目录首次运行 pod install
。
需求
- iOS 9.0
- Swift 4.2
安装
EachNavigationBar 可通过 CocoaPods 或 Carthage 特定于 CocoaPods 使用。安装方法,只需将以下行添加到您的 Podfile 或 Cartfile 即可
Podfile
pod 'EachNavigationBar'
Cartfile
github "Pircate/EachNavigationBar"
概览
用法
导入
import EachNavigationBar
启用
let nav = UINavigationController(rootViewController: vc)
nav.navigation.configuration.isEnabled = true
设置
全局
nav.navigation.configuration.titleTextAttributes = [.foregroundColor: UIColor.blue]
nav.navigation.configuration.barTintColor = UIColor.red
nav.navigation.configuration.shadowImage = UIImage(named: "shadow")
nav.navigation.configuration.setBackgroundImage(UIImage(named: "nav"), for: .any, barMetrics: .default)
nav.navigation.configuration.backItem = UINavigationController.Configuration.BackItem(style: .title("返回"))
nav.navigation.configuration.prefersLargeTitles = true
nav.navigation.configuration.largeTitle.displayMode = .always
每个视图控制器
普通
navigation.bar -> EachNavigationBar -> UINavigationBar
navigation.item -> UINavigationItem
// hide navigation bar
navigation.bar.isHidden = true
// remove blur effect
navigation.bar.isTranslucent = false
// hides shadow image
navigation.bar.isShadowHidden = true
// set status bar style
navigation.bar.statusBarStyle = .lightContent
// if you want change navigation bar position
navigation.bar.automaticallyAdjustsPosition = false
// item padding
navigation.bar.layoutPaddings = UIEdgeInsets(top: 0, left: 8, bottom: 0, right: 8)
// shadow
navigation.bar.shadow = Shadow(
color: UIColor.black.cgColor,
opacity: 0.5,
offset: CGSize(width: 0, height: 3)
)
Alpha
// set bar alpha
navigation.bar.alpha = 0.5
// set title alpha
navigation.bar.setTitleAlpha(0.5)
// set barButtonItem alpha
navigation.bar.setTintAlpha(0.5)
// if barButtonItem is customView
navigation.item.leftBarButtonItem?.customView?.alpha = 0.5
// if barButtonItem customized tintColor
navigation.item.leftBarButtonItem?.tintColor = navigation.item.leftBarButtonItem?.tintColor?.withAlphaComponent(0.5)
额外的观高度或视图
// navigation bar additional height
navigation.bar.additionalHeight = 14
// navigation bar additional view
navigation.bar.additionalView = UIView()
返回栏按钮项
// set back bar button item
navigation.bar.backBarButtonItem = .init(style: .title("Back"), tintColor: .red)
// allow back
navigation.bar.backBarButtonItem.shouldBack = { item in
// do something
return false
}
// handler before back
navigation.bar.backBarButtonItem.willBack = {
// do something
}
// handler after back
navigation.bar.backBarButtonItem.didBack = {
// do something
}
大标题(iOS 11.0+)
// enable
navigation.bar.prefersLargeTitles = true
// display mode
navigation.item.largeTitleDisplayMode = .always
// alpha
navigation.bar.setLargeTitleAlpha(0.5)
作者
Pircate, [email protected]
许可
EachNavigationBar遵循MIT许可协议。更多信息请参阅LICENSE文件。