ZXNavigationBar

       

安装

通过CocoaPods安装

pod 'ZXNavigationBar'

或手动导入

• 将ZXNavigationBar拖入项目中。

导入头文件

#import "ZXNavigationBarController.h"

---

功能&特点

• [x] 每个控制器单独管理自己的导航栏，导航栏属于控制器的子view，不再属于统一的导航控制器
• [x] 兼容iOS8-iOS18，兼容刘海屏、药丸屏、iPad等各种设备，适配横竖屏，无需担心系统更新需要重新适配导航栏
• [x] 仅需一行代码即可轻松设置导航栏背景图片、背景色、导航栏渐变、状态栏颜色、Item大小和边距等各类属性
• [x] 仅需一行代码即可实现拦截pop手势与点击返回事件，并决定是否要响应pop操作
• [x] 仅需一行代码即可解决scrollView横向滚动与pop手势冲突问题
• [x] 支持随时切换为系统导航栏，且与系统导航栏之间无缝衔接
• [x] 支持自定义ZXNavigationBar高度
• [x] 支持在ZXNavigationBar上自定义titleView与navItemView
• [x] 若ZXNavigationBar自带效果都无法满足，支持任意自定义导航栏View
• [x] 支持导航栏折叠、支持跟随ScrollView滚动透明度自动改变
• [x] 支持通过url加载导航栏Item图片
• [x] 支持全屏手势返回
• [x] 支持自定义手势返回范围
• [x] 支持监听手势返回进度
• [x] 仿系统导航栏历史堆栈效果，支持iOS8-iOS16，支持自定义基本样式
• [x] 若从Xib中加载控制器View，添加子View无需手动设置距离导航栏顶部约束，ZXNavigationBar会自动处理

反馈&交流qq群：790460711

效果预览

导航栏设置 | 仿微博热搜效果 | 自定义导航栏
-|-|- | | |

自定义titleView | 兼容scrollView横向滚动 | 可伸缩式导航栏 -|-|- | | |

开始使用

将控制器继承于ZXNavigationBarController，建议将Base控制器继承于ZXNavigationBarController

@interface DemoBaseViewController : ZXNavigationBarController

@end

【建议，非必须】将导航控制器继承于ZXNavigationBarNavigationController，建议将Base导航控制器继承于ZXNavigationBarNavigationController

@interface DemoBaseNavigationController : ZXNavigationBarNavigationController

@end

【重要】注意事项

• ZXNavigationBar会自动显示返回按钮，且实现点击pop功能，您无需设置，若需要自定义返回按钮，直接覆盖self.zx_navLeftBtn的图片和点击回调即可
• 如果项目中存在黑白状态栏交替的需求，建议先在base控制器的viewDidLoad方法中统一设置状态栏颜色，以避免设置成白色状态栏后返回上一个页面无法自动恢复为黑色状态栏

@interface DemoBaseViewController : ZXNavigationBarController
- (void)viewDidLoad{
    [super viewDidLoad];
    self.zx_navStatusBarStyle = ZXNavStatusBarStyleDefault;
}
@end

• 在跳转到使用系统导航栏的页面（如系统相册、icloud drive）出现控制器内容上移被系统导航栏遮挡的问题时，请在跳转前设置

UIScrollView.appearance.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentAutomatic;

• 【导航控制器为ZXNavigationBarNavigationController或其子类时，可忽略此步操作！！】ZXNavigationBarController作了自动隐藏导航栏的处理，但由于导航栏早于内部子控制器加载，因此有可能造成自定义导航栏抖动或状态栏颜色黑白相嵌的问题， 若您遇到此问题，请在base导航控制器的pushViewController:animated:中设置self.navigationBarHidden = YES;或在Appdelegate的application:didFinishLaunchingWithOptions:中调用方法[UINavigationController zx_hideAllNavBar](需要先#import "ZXNavigationBarController.h")

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //这个方法需要在导航控制器加载前调用
    [UINavigationController zx_hideAllNavBar];
    
    UIWindow *window = [[UIWindow alloc]initWithFrame:[UIScreen mainScreen].bounds];
    DemoListViewController *vc = [[DemoListViewController alloc]init];
    UINavigationController *nav = [[UINavigationController alloc]initWithRootViewController:vc];
    window.rootViewController = nav;
    [window makeKeyAndVisible];
    self.window = window;
    return YES;
}
@end

【重要】如果您在项目中使用了FDFullscreenPopGesture

• ZXNavigationBar支持全屏手势返回和拦截，建议您移除其他的第三方全屏手势返回框架以避免冲突。
• 若自定义导航栏与系统导航栏同在一个项目中，您可以在继承于ZXNavigationBarController的跟控制器的初始化方法书写以下代码以兼容FDFullscreenPopGesture:

//因FDFullscreenPopGesture默认会在控制器即将展示时显示系统导航栏，与ZXNavigationBar共同使用时会造成系统导航栏出现一下又马上消失，因此需要以下设置
self.fd_prefersNavigationBarHidden = YES;
//当您通过zx_handlePopBlock拦截侧滑返回手势时，请设置fd_interactivePopDisabled为YES以关闭FDFullscreenPopGesture在当前控制器的全屏返回手势，否则无法拦截。
self.fd_interactivePopDisabled = YES;

【重要】ZXNavigationBar对于自定义导航栏view内容无法自动下移的处理方式

如果App使用的是系统的导航栏且不透明，view的内容会自动下移，例如非刘海屏会下移64像素；若设置了自定义的导航栏，因为它实际上就是普通的View，则控制器view中的内容不会自动下移以避免挡住导航栏。

• ZXNavigationBar的处理方法是：
• 如果您是通过frame或者Masonry设置控件布局，请设置y距离顶部高度为导航栏高度，可直接使用ZXNavBarHeight这个宏
• 如果您是通过Xib加载控制器View，则ZXNavigationBar会自动将内部约束设置为距离顶部为导航栏高度+原始高度，您无需作任何处理

导航栏设置

注意:以下设置均在控制器中进行，self代表当前控制器(当前控制器需继承于ZXNavigationBarController)

设置导航栏标题

self.title = @"ZXNavigationBar";

或

self.zx_navTitle = @"ZXNavigationBar";

设置导航栏标题颜色

self.zx_navTitleColor = [UIColor redColor];

设置导航栏标题字体大小

self.zx_navTitleFontSize = 20;

或

self.zx_navTitleFont = [UIFont systemFontOfSize:20];

• 设置导航栏标题其他非frame属性，通过控制self.zx_navTitleLabel即可

自定义导航栏frame

self.zx_navFixFrame = CGRectMake(0, 0, 100, 100);

导航栏frame发生改变时的回调，可在这个block中return修改后的frame

self.zx_navHandleFrameBlock = ^CGRect(CGRect oldFrame) {
    return CGRectMake(0, 0, 100, 100);
};

设置导航栏默认返回按钮图片，若不设置则使用默认的返回按钮图片

self.zx_backBtnImageName = @"newBackImageName";

快速设置左侧/右侧的按钮和点击回调(以最右侧按钮为例)

• 设置最右侧按钮的图片名和点击回调

[self zx_setRightBtnWithImgName:@"set_icon" clickedBlock:^(UIButton * _Nonnull btn) {
    NSLog(@"点击了最右侧的Button");
}];

• 设置最右侧按钮的文字和点击回调

[self zx_setRightBtnWithText:@"右侧按钮" clickedBlock:^(UIButton * _Nonnull btn) {
    NSLog(@"点击了最右侧的Button");
}];

• 设置最右侧按钮的图片对象和点击回调

[self zx_setRightBtnWithImg:image对象 clickedBlock:^(ZXNavItemBtn * _Nonnull btn) {
    NSLog(@"点击了最右侧的Button");  
}];

• 设置最右侧按钮的图片Url和点击回调(需导入SDWebImage并在pch文件中#import <SDWebImage/UIButton+WebCache.h>)

[self zx_setRightBtnWithImgUrl:@"图片url地址" placeholderImgName:@"占位图名称" clickedBlock:^(ZXNavItemBtn * _Nonnull btn) {
    NSLog(@"点击了最右侧的Button");  
}];

根据左侧/右侧的按钮对象进行具体设置(以左侧按钮为例)

• 如果需要导航栏显示返回图标和返回文字

//由于ZXNavigationBar会自动在左侧添加返回图片和点击返回事件，因此只需要设置返回的文字即可
[self.zx_navLeftBtn setTitle:@"返回" forState:UIControlStateNormal];

• 设置导航栏左侧/右侧的按钮的其他非frame相关属性，通过控制self.zx_navLeftBtn/zx_navRightBtn即可

将图片渲染为指定颜色

//将oldImage渲染为红色
UIImage *resultImage = [oldImage zx_renderingColor:[UIColor redColor]];

设置左侧/右侧的按钮的大小

//将按钮宽高设置为30
self.zx_navItemSize = 30;

设置左侧/右侧的按钮的间距与边距

//将按钮边距设置为0
self.zx_navItemMargin = 0;

设置右侧第二个按钮

• 将上述例子中zx_navLeftBtn/zx_navRightBtn修改为zx_navSubRightBtn即可

设置左侧第二个按钮

• 将上述例子中zx_navLeftBtn/zx_navRightBtn修改为zx_navSubLeftBtn即可

单独设置指定ZXNavItemBtn的属性（ZXNavItemBtn在导航栏中从左到右分别为zx_navLeftBtn,zx_navSubLeftBtn,zx_navSubRightBtn,zx_navRightBtn），以下以zx_navLeftBtn为例：

• 设置NavItemBtn的image颜色

self.zx_navLeftBtn.zx_imageColor = [UIColor redColor];

• 设置NavItemBtn的tintColor

self.zx_navLeftBtn.zx_tintColor = [UIColor redColor];

• 设置NavItemBtn的字体大小

self.zx_navLeftBtn.zx_fontSize = 12;

• 设置NavItemBtn的固定宽度，若设置，则ZXNavDefalutItemSize无效，若要恢复初始值，可设置为-1

self.zx_navLeftBtn.zx_fixWidth = 100;

• 设置NavItemBtn的固定高度，若设置，则自动计算宽度无效(若需要恢复自动宽度，可设置zx_fixWidth为-1)

self.zx_navLeftBtn.zx_fixHeight = 100;

• 设置NavItemBtn距离左边元素的固定距离，若要恢复初始值，可设置为-1

self.zx_navLeftBtn.zx_fixMarginLeft = 15;

• 设置NavItemBtn距离右边元素的固定距离，若要恢复初始值，可设置为-1

self.zx_navLeftBtn.zx_fixMarginRight = 15;

• 禁止自动调整NavItemBtn图片和文字的布局，若要使contentEdgeInsets、titleEdgeInsets、imageEdgeInsets等，则需要将此属性设置为NO

self.zx_navLeftBtn.zx_disableAutoLayoutImageAndTitle = YES;

• 设置NavItemBtn image的固定大小

self.zx_navLeftBtn.zx_fixImageSize = CGSizeMake(10,10);

• 设置NavItemBtn自动计算宽度后的附加宽度

self.zx_navLeftBtn.zx_textAttachWidth = 20;

• 设置NavItemBtn文字的附加高度

self.zx_navLeftBtn.zx_textAttachHeight = 10;

• 设置NavItemBtn的cornerRadius为高度的一半(圆形圆角)

self.zx_navLeftBtn.zx_setCornerRadiusRounded = YES;

• 设置NavItemBtn内部图片x轴的偏移量，负数代表左移，无title且设置了zx_fixImageSize后生效，仅改变内容imageView的位移，不会改变原始NavItemBtn的frame

self.zx_navLeftBtn.zx_imageOffsetX = -10;

• 设置NavItemBtn的tintColor仅用于UIControlStateNormal状态(请在zx_imageColor和zx_tintColor之前设置)，默认为NO

self.zx_navLeftBtn.zx_useTintColorOnlyInStateNormal = YES;

• 自定义NavItemView

self.zx_navLeftBtn.zx_customView = [UISwitch new];

• 设置NavItemBtn frame发生改变时的回调，可在这个block中return修改后的frame

self.zx_navLeftBtn.zx_handleFrameBlock = ^CGRect(CGRect oldFrame) {
    return CGRectMake(oldFrame.origin.x, oldFrame.origin.y, oldFrame.size.width + 10, 30);
};

设置导航栏背景颜色

self.zx_navBarBackgroundColor = [UIColor orangeColor];

设置导航栏背景图片

self.zx_navBarBackgroundImage = [UIImage imageNamed:@"nav_bac"];

设置导航栏渐变背景

//从magentaColor到cyanColor渐变
[self zx_setNavGradientBacFrom:[UIColor magentaColor] to:[UIColor cyanColor]];

移除导航栏渐变背景

[self zx_removeNavGradientBac];

设置导航栏TintColor(此属性可以将导航栏的title颜色、左右Button的文字和图片颜色修改为TintColor)

self.zx_navTintColor = [UIColor yellowColor];

自定义导航栏高度(若设置此属性，ZXNavigationBar将不再使用默认的导航栏高度)

self.zx_navFixHeight = 30;

设置导航栏大小标题效果

[self zx_setMultiTitle:@"ZXNavigationBar" subTitle:@"subTitle"];

或

[self zx_setMultiTitle:@"ZXNavigationBar" subTitle:@"subTitle" subTitleFont:[UIFont systemFontOfSize:10] subT