前言
navigationBar 作为 UINavigationController 的只读属性,可定制改变的空间很小。
目录
-
- UINavigationBar 的属性和方法介绍
-
- UINavigationBarDelegate
一、UINavigationBar 的属性和方法介绍
// 设置导航条风格,包括状态栏字体、title 字体颜色都跟着改变
// 默认时白底黑字,如果 translucent 为 YES 时,底不是纯白色会有透明效果
// Black 时黑底白字,如果 translucent 为 YES 时,底不是纯黑色会有透明效果
@property(nonatomic,assign) UIBarStyle barStyle UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
// 定义在 UIInterface.h 里面的枚举
// 默认和 black,另外两个被 Deprecated
typedef NS_ENUM(NSInteger, UIBarStyle) {
UIBarStyleDefault = 0,
UIBarStyleBlack = 1,
UIBarStyleBlackOpaque = 1, // Deprecated. Use UIBarStyleBlack
UIBarStyleBlackTranslucent = 2, // Deprecated. Use UIBarStyleBlack and set the translucent property to YES
} __TVOS_PROHIBITED;
black_ translucent_NO.png
black_ translucent_YES.png
default_ translucent_NO.png
default_ translucent_YES.png
// 代理对象
@property(nullable,nonatomic,weak) id delegate;
// iOS 7 后新定义了该属性
// 默认是 YES。在 iOS 6 以及之前,默认是 NO
// 如果 barStyle 设置为 UIBarStyleBlackTranslucent,则该属性总是为 YES
// 可以设置为 NO,取消导航条的透明效果,这里有一点要注意,透明与不透明的页面顶部布局不同
// 该属性会对设置的背景图片的图片本身的透明度产生影响
@property(nonatomic,assign,getter=isTranslucent) BOOL translucent NS_AVAILABLE_IOS(3_0) UI_APPEARANCE_SELECTOR;
// push 一个自定义的 navigationItem 显示在 navigationBar 的中心
// 如果已经有一个 navigationItem 了,则会在左边显示一个返回按钮
- (void)pushNavigationItem:(UINavigationItem *)item animated:(BOOL)animated;
// pop 操作,和上面的 push 对应
- (nullable UINavigationItem *)popNavigationItemAnimated:(BOOL)animated;
// 只读属性,顶上的 navigationItem
@property(nullable, nonatomic,readonly,strong) UINavigationItem *topItem;
// 只读属性,紧挨着 topItem 后面的第一个 navigationItem,navigationBar 执行 pop 后,该 backItem 会变为 topItem
@property(nullable, nonatomic,readonly,strong) UINavigationItem *backItem;
// 存放所有 navigationItem 的数组
@property(nullable,nonatomic,copy) NSArray *items;
// 设置新的 navigationItem 数组和导航控制器的 setViewControllers: 方法,极其类似
- (void)setItems:(nullable NSArray *)items animated:(BOOL)animated;
// iOS 11 后出现的,navigationBar 加宽,title 字体加粗加大
@property (nonatomic, readwrite, assign) BOOL prefersLargeTitles UI_APPEARANCE_SELECTOR API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos);
prefersLargeTitles.png
// iOS 7 后改变了 tintColor 的定义。它不在影响 navigationBar 的背景,主要影响navigationBar 上按钮的标题颜色
// 给 navigationBar 着色时,使用 barTintColor。
@property(null_resettable, nonatomic,strong) UIColor *tintColor;
// iOS 7 后出现的,设置 navigationBar 的背景颜色,默认是 nil
@property(nullable, nonatomic,strong) UIColor *barTintColor NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR;
// iOS 7 后出现的,设置 navigationBar 的背景图片
// barMetrics 参数表示屏幕的方向,Default 表示横竖屏用同一张背景图,Compact 表示横屏时用的背景图
// 可以调用该方法两次,分别设置竖屏时的背景图和横屏时的背景图
- (void)setBackgroundImage:(nullable UIImage *)backgroundImage forBarPosition:(UIBarPosition)barPosition barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR;
// 返回指定 barPosition 和 barMetrics 下的 UIImage (打印的其实是: _UIResizableImage)
- (nullable UIImage *)backgroundImageForBarPosition:(UIBarPosition)barPosition barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR;
// UIBarCommon.h 中定义的 UIBarPosition 枚举,用来表示 bar 的位置
typedef NS_ENUM(NSInteger, UIBarPosition) {
UIBarPositionAny = 0,
UIBarPositionBottom = 1, // The bar is at the bottom of its local context, and directional decoration draws accordingly (e.g., shadow above the bar).
UIBarPositionTop = 2, // The bar is at the top of its local context, and directional decoration draws accordingly (e.g., shadow below the bar)
UIBarPositionTopAttached = 3, // The bar is at the top of the screen (as well as its local context), and its background extends upward—currently only enough for the status bar.
} NS_ENUM_AVAILABLE_IOS(7_0);
// UIBarCommon.h 中定义的 UIBarMetrics 枚举,用来表示 bar 是否设置了 prompt 和 横竖屏的状态的四种组合
typedef NS_ENUM(NSInteger, UIBarMetrics) {
UIBarMetricsDefault,
UIBarMetricsCompact,
UIBarMetricsDefaultPrompt = 101, // Applicable only in bars with the prompt property, such as UINavigationBar and UISearchBar
UIBarMetricsCompactPrompt,
UIBarMetricsLandscapePhone NS_ENUM_DEPRECATED_IOS(5_0, 8_0, "Use UIBarMetricsCompact instead") = UIBarMetricsCompact,
UIBarMetricsLandscapePhonePrompt NS_ENUM_DEPRECATED_IOS(7_0, 8_0, "Use UIBarMetricsCompactPrompt") = UIBarMetricsCompactPrompt,
};
// 相当于 UIBarPositionAny 下的 -setBackgroundImage:forBarPosition:barMetrics:
// 当 position 是 UIBarPositionTopAttached 的时候,如果需要,图片大小将会垂直拉伸
- (void)setBackgroundImage:(nullable UIImage *)backgroundImage forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
- (nullable UIImage *)backgroundImageForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// iOS 6 后出现的,默认是 nil,导航条底部的分割线
// 当不为 nil 时,一个自定义的阴影图像代替默认的阴影图像。
// 对于要显示的自定义阴影,自定义背景图片必须通过 -setBackgroundImage:forBarMetrics: 设置。
// 如果使用默认背景图片,则默认的阴影图片也会使用
@property(nullable, nonatomic,strong) UIImage *shadowImage NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
// iOS 6 后出现的,设置 title 的富文本
@property(nullable,nonatomic,copy) NSDictionary *titleTextAttributes NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// iOS 11 后出现的,设置 largeTitle 富文本
@property(nullable, nonatomic, copy) NSDictionary *largeTitleTextAttributes UI_APPEARANCE_SELECTOR API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos);
// iOS 5 后出现的,设置 title 的垂直偏移,对 largeTitle 无效
// 设置 adjustment 小于 -11 和 大于 32 时控制台打印约束不安全警告
- (void)setTitleVerticalPositionAdjustment:(CGFloat)adjustment forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// 返回 title 垂直偏移的大小
- (CGFloat)titleVerticalPositionAdjustmentForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// iOS 7 后出现的,更改 backBarButtonItem 的图片,要两个属性同时修改,只更改一个不起作用
@property(nullable,nonatomic,strong) UIImage *backIndicatorImage NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
@property(nullable,nonatomic,strong) UIImage *backIndicatorTransitionMaskImage NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
二、UINavigationBarDelegate:
@protocol UINavigationBarDelegate
// 定义在 UIBarCommon.h 中,
@protocol UIBarPositioning // UINavigationBar, UIToolbar, and UISearchBar conform to this
@property(nonatomic,readonly) UIBarPosition barPosition;
@end
@protocol UIBarPositioningDelegate // UINavigationBarDelegate, UIToolbarDelegate, and UISearchBarDelegate all extend from this
@optional
/* Implement this method on your manual bar delegate when not managed by a UIKit controller.
UINavigationBar and UISearchBar default to UIBarPositionTop, UIToolbar defaults to UIBarPositionBottom.
This message will be sent when the bar moves to a window.
*/
// 设置 UIBarPosition
- (UIBarPosition)positionForBar:(id )bar;
@end
// 设置能否进行 push, 如果返回 NO 则 navigationBar 不能进行 push
// 但是即使返回 NO,在 viewDidLoad 里面执行的 push 还是能进行,但是后续点击按钮执行 push 则不行
- (BOOL)navigationBar:(UINavigationBar *)navigationBar shouldPushItem:(UINavigationItem *)item;
// 如果 push 时有动画,则动画结束回调,如果没有动画,则立即回调
- (void)navigationBar:(UINavigationBar *)navigationBar didPushItem:(UINavigationItem *)item;
// pop,和上面的 push 逻辑一样
- (BOOL)navigationBar:(UINavigationBar *)navigationBar shouldPopItem:(UINavigationItem *)item;
- (void)navigationBar:(UINavigationBar *)navigationBar didPopItem:(UINavigationItem *)item;
navigationBar 的内容比较简单,好像没有什么会被日常开发所忽略的。共勉。
end