前言
UIToolbar 第一次接触是因为 导航控制器的 toolbarHidden 和 toolbar 属性。
目录
- UIToolbar 的属性和方法
- UIBarItem 的属性和方法
- UIBarButtonItem 的属性和方法
一、UIToolbar 的属性和方法
// 定义中规中矩，继承 UIView，遵守 UIBarPositioning 协议。
NS_CLASS_AVAILABLE_IOS(2_0) __TVOS_PROHIBITED @interface UIToolbar : UIView <UIBarPositioning>
// 很眼熟的属性，和 UINavigationBar 一模一样
@property(nonatomic) UIBarStyle barStyle UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED; // default is UIBarStyleDefault
// 如果是 navigationController.toolbar，UIToolbar 受 UINavigationController 控制时，设置 方法无效，需要使用 UIViewController (UINavigationControllerContextualToolbarItems) 中的 toolbarItems 的设置方法
// 设置或读取 显示 UIBarButtonItem，默认是 nil，更改没有动画，在 UIToolbar 上按顺序显示
@property(nullable, nonatomic, copy) NSArray<UIBarButtonItem *> *items;
// 和 UINavigationBar 一模一样的属性，是否透明
@property(nonatomic,assign,getter=isTranslucent) BOOL translucent NS_AVAILABLE_IOS(3_0) UI_APPEARANCE_SELECTOR;
// 如果是 navigationController.toolbar，UIToolbar 受 UINavigationController 控制时，设置 方法无效，需要使用 UIViewController (UINavigationControllerContextualToolbarItems) 中的 toolbarItems 的设置方法
// 如果 animated 为 YES，将淡入淡出的重新排列和调整间距
- (void)setItems:(nullable NSArray<UIBarButtonItem *> *)items animated:(BOOL)animated;
// 按钮的 渲染颜色
@property(null_resettable, nonatomic, strong) UIColor *tintColor;
// UIToolbar 的背景颜色
@property(nullable, nonatomic, strong) UIColor *barTintColor NS_AVAILABLE_IOS(7_0) UI_APPEARANCE_SELECTOR;
// iOS 5 后出现的， 设置背景图片，barStyle、tintColor、backgroundImage 会相互影响，
- (void)setBackgroundImage:(nullable UIImage *)backgroundImage forToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
- (nullable UIImage *)backgroundImageForToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// iOS 6 后出现的，设置阴影图片
- (void)setShadowImage:(nullable UIImage *)shadowImage forToolbarPosition:(UIBarPosition)topOrBottom NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
- (nullable UIImage *)shadowImageForToolbarPosition:(UIBarPosition)topOrBottom NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
// iOS 7 后出现的，当 UIToolbar 由 UINavigationController 控制时也许不需要设置代理对象
@property(nullable, nonatomic, weak) id<UIToolbarDelegate> delegate NS_AVAILABLE_IOS(7_0);
二、UIBarItem 的属性和方法
该类的内容比较少，只做简要分析。
// 继承自 NSObject，遵守 NSCoding 和 UIAppearance 协议
// 这里的 UIAppearance 后面再详细分析
NS_CLASS_AVAILABLE_IOS(2_0) @interface UIBarItem : NSObject <NSCoding, UIAppearance>
// 两个指定的初始化方法，大家耳熟能详
- (instancetype)init NS_DESIGNATED_INITIALIZER;
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;
// 是否激活，即是否可点击，默认为 YES
@property(nonatomic,getter=isEnabled) BOOL enabled; // default is YES
// 标题，默认为 nil
@property(nullable, nonatomic,copy) NSString *title; // default is nil
// 图片，默认为 nil
@property(nullable, nonatomic,strong) UIImage *image; // default is nil
// iOS 5 后出现的，横屏下的图片，默认是 nil
@property(nullable, nonatomic,strong) UIImage *landscapeImagePhone NS_AVAILABLE_IOS(5_0) __TVOS_PROHIBITED; // default is nil
// iOS 11 后出现的，标准图像的高分辨率版本，默认是 nil，
// 用于渲染辅助 UI，例如对于需要大文本的视障人士使用。如果没有提供，系统可能会尝试基于标准的图像去生成图像。
// (例如，通过以更高的分辨率光栅化匹配的PDF 表示法在更高的一个分辨率下)
// 此处体现了苹果的人文关怀
@property(nullable, nonatomic,strong) UIImage *largeContentSizeImage API_AVAILABLE(ios(11.0));
// Image 的缩进，默认是 UIEdgeInsetsZero
@property(nonatomic) UIEdgeInsets imageInsets;
// iOS 5 后出现的，横屏下的图片缩进，默认也是 UIEdgeInsetsZero，当然只有在 landscapeImagePhone 有值时该属性才有效
@property(nonatomic) UIEdgeInsets landscapeImagePhoneInsets NS_AVAILABLE_IOS(5_0) __TVOS_PROHIBITED;
// iOS 11 后出现的，largeContentSizeImage 的缩进，同上
@property(nonatomic) UIEdgeInsets largeContentSizeImageInsets API_AVAILABLE(ios(11.0));
// tag 值，默认是 0
@property(nonatomic) NSInteger tag;
// iOS 5 后出现的，设置某个 state 下的 title 的属性
- (void)setTitleTextAttributes:(nullable NSDictionary<NSAttributedStringKey,id> *)attributes forState:(UIControlState)state NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// 获取某个 state 下的 title 的属性
- (nullable NSDictionary<NSString *,id> *)titleTextAttributesForState:(UIControlState)state NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
三、UIBarButtonItem 的属性和方法
// 首先是定义，继承自 UIBarItem，遵守 NSCoding 属性
NS_CLASS_AVAILABLE_IOS(2_0) @interface UIBarButtonItem : UIBarItem <NSCoding>
// 全部的初始化方法，可能我们对 title 和 image 初始化比较熟悉了，这里主要看最后的两个初始化方法
- (instancetype)init NS_DESIGNATED_INITIALIZER;
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;
- (instancetype)initWithImage:(nullable UIImage *)image style:(UIBarButtonItemStyle)style target:(nullable id)target action:(nullable SEL)action;
- (instancetype)initWithImage:(nullable UIImage *)image landscapeImagePhone:(nullable UIImage *)landscapeImagePhone style:(UIBarButtonItemStyle)style target:(nullable id)target action:(nullable SEL)action NS_AVAILABLE_IOS(5_0); // landscapeImagePhone will be used for the bar button image when the bar has Compact or Condensed bar metrics.
- (instancetype)initWithTitle:(nullable NSString *)title style:(UIBarButtonItemStyle)style target:(nullable id)target action:(nullable SEL)action;
// 使用系统提供的 UIBarButtonSystemItem 创建 UIBarButtonItem
- (instancetype)initWithBarButtonSystemItem:(UIBarButtonSystemItem)systemItem target:(nullable id)target action:(nullable SEL)action;
// 使用 一个自定义 view 创建 UIBarButtonItem
- (instancetype)initWithCustomView:(UIView *)customView;
// 首先看一下 Plain 和 Done 的区别，Done 的字体比 Plain 粗一些
typedef NS_ENUM(NSInteger, UIBarButtonItemStyle) {
UIBarButtonItemStylePlain,
UIBarButtonItemStyleBordered NS_ENUM_DEPRECATED_IOS(2_0, 8_0, "Use UIBarButtonItemStylePlain when minimum deployment target is iOS7 or later"),
UIBarButtonItemStyleDone,
};
plainAndDone.png
// 系统提供的样式，且 UIBarButtonItemStyle 默认是 Plain，字体较细一些的样式
typedef NS_ENUM(NSInteger, UIBarButtonSystemItem) {
UIBarButtonSystemItemDone, // title 是 Done
UIBarButtonSystemItemCancel, // title 是 Cancel
UIBarButtonSystemItemEdit, // title 是 Edit
UIBarButtonSystemItemSave, // title 是 Save
UIBarButtonSystemItemAdd, // image 是一个加号的图片
UIBarButtonSystemItemFlexibleSpace, // 空白占位按钮，不能单独使用，要给和其它 barItem 一起放在数组里面，灵活的间隔
UIBarButtonSystemItemFixedSpace, // 同上，固定间隔
UIBarButtonSystemItemCompose, // image 是一个编辑的图片
UIBarButtonSystemItemReply, // image 是一个回答的图片
UIBarButtonSystemItemAction, // image 是一个分析的图片
UIBarButtonSystemItemOrganize, // image 是一个文件夹的图片
UIBarButtonSystemItemBookmarks, // image 是一个书本展开的图片
UIBarButtonSystemItemSearch, // image 是一个搜索的图片
UIBarButtonSystemItemRefresh, // image 是一个刷新的图片
UIBarButtonSystemItemStop, // image 是一个 X 的图片
UIBarButtonSystemItemCamera, // image 是一个相机的图片
UIBarButtonSystemItemTrash, // image 是一个垃圾桶的图片
UIBarButtonSystemItemPlay, // image 是一个播放按钮的图片
UIBarButtonSystemItemPause, // image 是一个暂停按钮的图片
UIBarButtonSystemItemRewind, // image 是一个回退的图片
UIBarButtonSystemItemFastForward, // image 是一个前进的图片
UIBarButtonSystemItemUndo NS_ENUM_AVAILABLE_IOS(3_0), // title 是 Undo
UIBarButtonSystemItemRedo NS_ENUM_AVAILABLE_IOS(3_0), // title 是 Redo
UIBarButtonSystemItemPageCurl NS_ENUM_DEPRECATED_IOS(4_0, 11_0) // 废弃
};
// 默认是 UIBarButtonItemStylePlain
@property(nonatomic) UIBarButtonItemStyle style;
// 宽度，默认是 0
@property(nonatomic) CGFloat width; // default is 0.0
// 可能的标题集合，没看懂这个属性是啥意思
@property(nullable, nonatomic,copy) NSSet<NSString *> *possibleTitles; // default is nil
// 自定义 View，当使用自定义 View 创建 UIBarButtonItem 时，指向该自定义 View
@property(nullable, nonatomic,strong) __kindof UIView *customView; // default is nil
// 点击方法
@property(nullable, nonatomic) SEL action; // default is NULL
// 目标对象
@property(nullable, nonatomic,weak) id target; // default is nil
// iOS 5 后出现的，设置背景图片，可指定状态和屏幕方向
// 外观修饰符
// 通过 [UIBarButtonItem appearance] 代理定制所有按钮，或者用一个按钮实例调用该方法定制一个特殊的按钮，它也能用于 UINavigationItem 和 UIToolbar 上所有的按钮上
// 一般来说，应为没有自定义值集的其他状态指定正常状态的值
// 同样，要针对横竖屏下按钮宽度和高度不同做调整
// 为按钮的任何样式设置图片
- (void)setBackgroundImage:(nullable UIImage *)backgroundImage forState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
- (nullable UIImage *)backgroundImageForState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// iOS 6 后出现的，添加 UIBarButtonItemStyle 参数
- (void)setBackgroundImage:(nullable UIImage *)backgroundImage forState:(UIControlState)state style:(UIBarButtonItemStyle)style barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
- (nullable UIImage *)backgroundImageForState:(UIControlState)state style:(UIBarButtonItemStyle)style barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
// iOS 5 后出现的，渲染颜色
@property(nullable, nonatomic,strong) UIColor *tintColor NS_AVAILABLE_IOS(5_0);
// iOS 5 后出现的，设置 Background 垂直方向的偏移量，image 不为 nil 时有效，title 不为 nil 时无效，貌似针对有 image 的按钮
- (void)setBackgroundVerticalPositionAdjustment:(CGFloat)adjustment forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
- (CGFloat)backgroundVerticalPositionAdjustmentForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
adjustment_0.png
adjustment_5.png
// iOS 5 后出现的，调整 title 的位置，调整水平方向的位置，左右偏移量，垂直方向无效
- (void)setTitlePositionAdjustment:(UIOffset)adjustment forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
- (UIOffset)titlePositionAdjustmentForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
// 定义在 UIGeometry.h 里面的结构体
typedef struct UIOffset {
CGFloat horizontal, vertical; // specify amount to offset a position, positive for right or down, negative for left or up
} UIOffset;
// iOS 5 后出现的，只针对返回按钮的设置方法，该按钮位于 UINavigationItem 上 `@property(nullable,nonatomic,strong) UIBarButtonItem *backBarButtonItem __TVOS_PROHIBITED; // Bar button item to use for the back button in the child navigation item.`
// 设置背景图片
- (void)setBackButtonBackgroundImage:(nullable UIImage *)backgroundImage forState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
- (nullable UIImage *)backButtonBackgroundImageForState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
// 设置 title 的垂直偏移
- (void)setBackButtonTitlePositionAdjustment:(UIOffset)adjustment forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
- (UIOffset)backButtonTitlePositionAdjustmentForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
// 设置 Background 的垂直偏移
- (void)setBackButtonBackgroundVerticalPositionAdjustment:(CGFloat)adjustment forBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
- (CGFloat)backButtonBackgroundVerticalPositionAdjustmentForBarMetrics:(UIBarMetrics)barMetrics NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR __TVOS_PROHIBITED;
// 只针对 iOS 的 SpringLoading 分类，且遵守 UISpringLoadedInteractionSupporting
#if TARGET_OS_IOS
@interface UIBarButtonItem (SpringLoading) <UISpringLoadedInteractionSupporting>
@end
#endif
// iOS 11 后出现的，定义在 UISpringLoadedInteractionSupporting.h 中，弹簧作用
API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos, watchos)
@protocol UISpringLoadedInteractionSupporting <NSObject>
@property (nonatomic, assign, getter=isSpringLoaded) BOOL springLoaded UIKIT_AVAILABLE_IOS_ONLY(11_0);
@end
到这里就结束，相关的 .h 文件都看完了，是否对导航栏有一个全面的认识了呢，对后面的完全自定义导航栏有什么启发呢。emmm...
end
