产品简介
ZXNavigationBar 是一款灵活轻量的iOS自定义导航栏。它解决了系统导航栏样式固定、修改困难、兼容性差等问题,让开发者能轻松实现导航栏渐变、背景图、折叠、全屏手势返回等高级效果,并完美兼容从iOS 8到最新系统的各种设备,适合需要精细控制应用导航栏样式的iOS开发者。

核心功能
- 每个控制器独立管理导航栏,彻底告别统一的导航控制器
- 兼容iOS 8至最新系统,全面适配刘海屏、药丸屏、iPad及横竖屏
- 一行代码即可设置背景图、背景色、渐变、Item大小边距等各类属性
- 支持全屏手势返回、自定义返回拦截,解决手势冲突问题
- 支持导航栏联动(如随ScrollView滚动改变透明度)、折叠等高级交互效果
快速开始
- 第一步:通过CocoaPods安装:在Podfile中添加 `pod ‘ZXNavigationBar‘`,然后执行 `pod install`。
- 第二步:让您的基础控制器继承自 `ZXNavigationBarController`。
- 第三步:在控制器中通过 `self.title` 或 `self.zx_navTitle` 设置标题,使用 `self.zx_navTitleColor` 等属性快速自定义导航栏外观。
界面预览


与其他方案对比
| 对比项 | ZXNavigationBar | 同类方案 |
|---|---|---|
| 管理方式 | 导航栏属于控制器view,由每个控制器单独管理,样式隔离,互不影响。 | 系统导航栏由UINavigationController统一管理,样式修改影响全局,易冲突。 |
| 自定义灵活性 | 一行代码即可实现背景图、渐变、高度、Item布局等全方位自定义,支持任意自定义View。 | 系统导航栏自定义能力有限,通常需要通过隐藏原生栏并添加自定义view的复杂方式实现。 |
| 兼容性与适配 | 官方适配iOS 8-18及全系设备(刘海屏、iPad等),并处理了横竖屏、手势冲突等常见适配难题。 | 自定义导航栏方案常需开发者自行处理系统升级后的布局变化、新设备适配和手势冲突问题。 |
适合谁用
- 需要深度定制应用导航栏样式和交互的iOS开发者
- 开发需要兼容从iOS 8到最新系统多种设备和屏幕的应用的工程师
- 希望实现如导航栏渐变、滚动折叠、全屏手势返回等高级效果的移动端项目团队
下载与版本
当前最新版本为 1.4.1,发布于 2021-06-28。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/SmileZXLee/ZXNavigationBar