1099 lines
59 KiB
Markdown
1099 lines
59 KiB
Markdown
|
<p align="center"><a href="https://github.com/ChenYilong/CYLTabBarController"><img src="https://repository-images.githubusercontent.com/44896762/c1d6e880-a8d8-11e9-8bb4-2da8ebc06f0a"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
# [CN]CYLTabBarController【一行代码实现 Lottie 动画 TabBar】
|
|||
|
|
# [EN]CYLTabBarController [An animated tabBar supported by Lottie with one line of code]
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center">
|
|||
|
|
<a href="https://github.com/ChenYilong/CYLTabBarController/blob/master/CYLTabBarController.podspec"><img src="https://img.shields.io/badge/Pod-GetLatestVersion-green.svg?style=flat"></a>
|
|||
|
|
<a href=""><img src="https://img.shields.io/badge/Swift-compatible-orange.svg"></a>
|
|||
|
|
<a href=""><img src="https://img.shields.io/badge/platform-iOS%208.0%2B-ff69b5152950834.svg"></a>
|
|||
|
|
<a href="https://github.com/ChenYilong/CYLTabBarController/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=flat"></a>
|
|||
|
|
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center">
|
|||
|
|
<a href="https://github.com/ChenYilong/iOSBlog/issues/21"><img src="https://img.shields.io/static/v1.svg?label=QQ%E3%80%81Telegram%20Group&color=blue&message=%E7%82%B9%E5%87%BB%E8%8E%B7%E5%8F%96QQ%E3%80%81Telegram%E7%BE%A4%E4%BF%A1%E6%81%AF&color=green"></a>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<p align="center">
|
|||
|
|
<a href="https://github.com/ChenYilong/CYLTabBarController/releases.atom"><img src="https://img.shields.io/badge/RSS feed (full text feed)-订阅仓库版本更新-yellow.svg"></a>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<p align="center">
|
|||
|
|
<a href="https://github.com/ChenYilong/iOSBlog/releases.atom"><img src="https://img.shields.io/badge/RSS feed (full text feed)-订阅我的博客更新-yellow.svg"></a>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="http://ww4.sinaimg.cn/large/006tNc79ly1g5zsnmaw40g30go04ck08.gif"></a></p>
|
|||
|
|
|
|||
|
|
<p align="center">
|
|||
|
|
<a href="http://ww2.sinaimg.cn/large/006tNc79ly1g5et6q6sm5j30go0goaar.jpg"><img src="http://ww1.sinaimg.cn/large/006tNc79ly1g5esb5j4oaj300w00rdfn.jpg"></a>
|
|||
|
|
<a href="http://weibo.com/luohanchenyilong"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6um2edt3jj300w00q3y9.jpg"></a>
|
|||
|
|
<a href="https://twitter.com/iOSChenYilong"><img src="http://ww3.sinaimg.cn/large/006tNc79ly1g5erhikv2kj300w00wgld.jpg"></a>
|
|||
|
|
<a href="https://github.com/ChenYilong"><img src="http://ww3.sinaimg.cn/large/006tNc79gy1g5ercvzgxzj300w00wmwx.jpg"></a>
|
|||
|
|
<a href="https://qm.qq.com/cgi-bin/qm/qr?k=SEdIYBh52YzquCEo8cmPwgkko1VgSAlw&authKey=sGcG%2BGB81DW%2Ba8v3dCufFSNoxhykAU61Uz%2B%2BqDiKQN2BGHP2xHYVI2tc0Cah2lpu"><img src="http://ww1.sinaimg.cn/large/006tNc79ly1g5euf38fedj300w00wjr5.jpg"></a>
|
|||
|
|
<a href="https://t.me/iosobjc"><img src="http://ww2.sinaimg.cn/large/006tNc79ly1g5eus39934j300w00w0r1.jpg"></a>
|
|||
|
|
<a href="http://s.zhihu.com/BU5Mp"><img src="http://ww4.sinaimg.cn/large/006tNc79ly1g5eu9melwaj300w00w3ya.jpg"></a>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
--------------------------------------------
|
|||
|
|
|
|||
|
|
## [CN]阅读须知
|
|||
|
|
## [EN]Before Reading
|
|||
|
|
|
|||
|
|
- [CN] mark means Chinese language by default.
|
|||
|
|
- [EN] mark means English language.
|
|||
|
|
- [CN] [点此获取 QQ 群,Telegram 群交流信息]( https://github.com/ChenYilong/iOSBlog/issues/21) 。
|
|||
|
|
- [EN]Telegram Group to communicate the features or bugs: https://t.me/CYLTabBarController
|
|||
|
|
|
|||
|
|
|
|||
|
|
# [CN]谁在用?上架APP列表[EN]who are using?List of App published
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
APP name link icon | image |APP name link icon | image
|
|||
|
|
:-------------:|:-------------:|:-------------:|:-------------:
|
|||
|
|
海底捞 [App Store Link](https://itunes.apple.com/cn/app/%E6%B5%B7%E5%BA%95%E6%8D%9E/id553115181?l=en&mt=8)  |  | C家 [App Store Link](https://itunes.apple.com/cn/app/c%E5%AE%B6/id1123394197?l=en&mt=8)  | Lottie 效果  |
|
|||
|
|
淘必中-淘宝推出的一款具有营销购物功能的APP [App Store Link](https://itunes.apple.com/cn/app/%E6%B7%98%E5%BF%85%E4%B8%AD/id399737960?l=en&mt=8)  |  | 慧诊健康 [App Store Link](https://itunes.apple.com/cn/app/%E6%85%A7%E8%AF%8A%E5%81%A5%E5%BA%B7/id1434271846?mt=8) |
|
|||
|
|
究竟大学 [App Store Link](https://itunes.apple.com/us/app/%E7%A9%B6%E7%AB%9F%E5%A4%A7%E5%AD%A6/id1334531245?mt=8)  |  | 蕉片 - 短视频拍摄剪辑出电影大片 [App Store Link](https://itunes.apple.com/us/app/%E8%95%89%E7%89%87-%E7%9F%AD%E8%A7%86%E9%A2%91%E6%8B%8D%E6%91%84%E5%89%AA%E8%BE%91%E5%87%BA%E7%94%B5%E5%BD%B1%E5%A4%A7%E7%89%87/id1235972800?mt=8) |
|
|||
|
|
闪剧 - 可以玩的短视频 [App Store Link](https://itunes.apple.com/us/app/%E9%97%AA%E5%89%A7-%E5%8F%AF%E4%BB%A5%E7%8E%A9%E7%9A%84%E7%9F%AD%E8%A7%86%E9%A2%91/id1360997439?mt=8) |  | 土狗云商城 [App Store Link](https://itunes.apple.com/cn/app/%E5%9C%9F%E7%8B%97%E4%BC%98%E4%BA%AB/id1239005385?mt=8) |
|
|||
|
|
Analyst.ai [App Store Link](https://itunes.apple.com/us/app/analyst-ai/id1345754742?mt=8) |  | 美膳校园 [App Store Link](https://itunes.apple.com/us/app/%E7%BE%8E%E8%86%B3%E6%A0%A1%E5%9B%AD/id1447211131?mt=8) | 
|
|||
|
|
全聚星 [App Store Link](https://itunes.apple.com/us/app/%E5%85%A8%E8%81%9A%E6%98%9F/id1140827531?mt=8)  | | Yesoul [App Store Link](https://itunes.apple.com/us/app/yesoul/id1144444969?mt=8)  | 
|
|||
|
|
贵州充电通 [App Store Link](https://itunes.apple.com/us/app/%E8%B4%B5%E5%B7%9E%E5%85%85%E7%94%B5%E9%80%9A/id1455932848?mt=8&app=itunes&ign-mpt=uo%3D4)  |  | 卓尔购 [App Store Link](https://itunes.apple.com/cn/app/%E5%8D%93%E5%B0%94%E8%B4%AD-%E6%89%B9%E5%8F%91%E9%87%87%E8%B4%AD%E8%BF%9B%E8%B4%A7%E9%A6%96%E9%80%89/id1063104387?mt=8)  | 
|
|||
|
|
卓越管家 [App Store Link](https://itunes.apple.com/cn/app//id1268483803?mt=8)  |  | 悦守护 [App Store Link](https://itunes.apple.com/cn/app/%E6%82%A6%E5%AE%88%E6%8A%A4/id1347678565?mt=8) | 
|
|||
|
|
筑集采采购端 [App Store Link](https://itunes.apple.com/cn/app//id1041802973?mt=8)  |  | 筑集采供应端 [App Store Link](https://itunes.apple.com/fr/app//id1035221629?mt=8)  |  |
|
|||
|
|
桂富宝 [App Store Link](https://itunes.apple.com/nz/app/e%E8%81%94%E7%9B%9F%E5%95%86%E5%9F%8E/id979819957)  |  | 小猪奔奔 [App Store Link](https://itunes.apple.com/cn/app/%E5%B0%8F%E7%8C%AA%E5%A5%94%E5%A5%94-%E7%94%A8%E6%88%B7%E7%89%88/id1124274649?mt=8)  | 
|
|||
|
|
娃娃坞(开发中) |  | 更多APP请访问 [《使用 CYLTabBarController 做的 APP，来这里报道下吧》]( https://github.com/ChenYilong/CYLTabBarController/issues/314 ) | 如果你正在使用也请提交到这里 [《使用 CYLTabBarController 做的 APP，来这里报道下吧》]( https://github.com/ChenYilong/CYLTabBarController/issues/314 )
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## [CN]导航
|
|||
|
|
## [EN]CONTENTS
|
|||
|
|
|
|||
|
|
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
|||
|
|
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
|||
|
|
|
|||
|
|
|
|||
|
|
- [与其他自定义TabBarController的区别](#%E4%B8%8E%E5%85%B6%E4%BB%96%E8%87%AA%E5%AE%9A%E4%B9%89tabbarcontroller%E7%9A%84%E5%8C%BA%E5%88%AB)
|
|||
|
|
- [集成后的效果：](#%E9%9B%86%E6%88%90%E5%90%8E%E7%9A%84%E6%95%88%E6%9E%9C)
|
|||
|
|
- [项目结构](#%E9%A1%B9%E7%9B%AE%E7%BB%93%E6%9E%84)
|
|||
|
|
- [使用CYLTabBarController](#%E4%BD%BF%E7%94%A8cyltabbarcontroller)
|
|||
|
|
- [第一步：使用CocoaPods导入CYLTabBarController](#%E7%AC%AC%E4%B8%80%E6%AD%A5%E4%BD%BF%E7%94%A8cocoapods%E5%AF%BC%E5%85%A5cyltabbarcontroller)
|
|||
|
|
- [第二步：设置CYLTabBarController的两个数组：控制器数组和TabBar属性数组](#%E7%AC%AC%E4%BA%8C%E6%AD%A5%E8%AE%BE%E7%BD%AEcyltabbarcontroller%E7%9A%84%E4%B8%A4%E4%B8%AA%E6%95%B0%E7%BB%84%E6%8E%A7%E5%88%B6%E5%99%A8%E6%95%B0%E7%BB%84%E5%92%8Ctabbar%E5%B1%9E%E6%80%A7%E6%95%B0%E7%BB%84)
|
|||
|
|
- [第三步：将CYLTabBarController设置为window的RootViewController](#%E7%AC%AC%E4%B8%89%E6%AD%A5%E5%B0%86cyltabbarcontroller%E8%AE%BE%E7%BD%AE%E4%B8%BAwindow%E7%9A%84rootviewcontroller)
|
|||
|
|
- [第四步（可选）：创建自定义的形状不规则加号按钮](#%E7%AC%AC%E5%9B%9B%E6%AD%A5%E5%8F%AF%E9%80%89%E5%88%9B%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E7%9A%84%E5%BD%A2%E7%8A%B6%E4%B8%8D%E8%A7%84%E5%88%99%E5%8A%A0%E5%8F%B7%E6%8C%89%E9%92%AE)
|
|||
|
|
- [补充说明](#%E8%A1%A5%E5%85%85%E8%AF%B4%E6%98%8E)
|
|||
|
|
- [自定义 `TabBar` 样式](#%E8%87%AA%E5%AE%9A%E4%B9%89-tabbar-%E6%A0%B7%E5%BC%8F)
|
|||
|
|
- [捕获 TabBar 点击事件](#%E6%8D%95%E8%8E%B7-tabbar-%E7%82%B9%E5%87%BB%E4%BA%8B%E4%BB%B6)
|
|||
|
|
- [点击 TabBarButton 时添加动画](#%E7%82%B9%E5%87%BB-tabbarbutton-%E6%97%B6%E6%B7%BB%E5%8A%A0%E5%8A%A8%E7%94%BB)
|
|||
|
|
- [横竖屏适配](#%E6%A8%AA%E7%AB%96%E5%B1%8F%E9%80%82%E9%85%8D)
|
|||
|
|
- [访问初始化好的 CYLTabBarController 对象](#%E8%AE%BF%E9%97%AE%E5%88%9D%E5%A7%8B%E5%8C%96%E5%A5%BD%E7%9A%84-cyltabbarcontroller-%E5%AF%B9%E8%B1%A1)
|
|||
|
|
- [点击 PlusButton 跳转到指定 UIViewController](#%E7%82%B9%E5%87%BB-plusbutton-%E8%B7%B3%E8%BD%AC%E5%88%B0%E6%8C%87%E5%AE%9A-uiviewcontroller)
|
|||
|
|
- [让TabBarItem仅显示图标，并使图标垂直居中](#%E8%AE%A9tabbaritem%E4%BB%85%E6%98%BE%E7%A4%BA%E5%9B%BE%E6%A0%87%E5%B9%B6%E4%BD%BF%E5%9B%BE%E6%A0%87%E5%9E%82%E7%9B%B4%E5%B1%85%E4%B8%AD)
|
|||
|
|
- [多TabBar嵌套，并指定PlusButton位置](#%E5%A4%9Atabbar%E5%B5%8C%E5%A5%97%E5%B9%B6%E6%8C%87%E5%AE%9Aplusbutton%E4%BD%8D%E7%BD%AE)
|
|||
|
|
- [在 Swift 项目中使用 CYLTabBarController](#%E5%9C%A8-swift-%E9%A1%B9%E7%9B%AE%E4%B8%AD%E4%BD%BF%E7%94%A8-cyltabbarcontroller)
|
|||
|
|
- [搭配 Storyboard 使用 CYLTabBarController](#%E6%90%AD%E9%85%8D-storyboard-%E4%BD%BF%E7%94%A8-cyltabbarcontroller)
|
|||
|
|
- [源码实现原理](#%E6%BA%90%E7%A0%81%E5%AE%9E%E7%8E%B0%E5%8E%9F%E7%90%86)
|
|||
|
|
- [FAQ](#faq)
|
|||
|
|
|
|||
|
|
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 与其他自定义TabBarController的区别
|
|||
|
|
## Comparetion with other Libraries
|
|||
|
|
|
|||
|
|
[CN]特点 </p>[EN]Features |[CN]解释 </p>[EN]Explanation
|
|||
|
|
:-------------:|:-------------:
|
|||
|
|
[CN]一行代码支持Lottie动画TabBar样式 </p> [EN] It only needs one line of code to have an animated TabBar with Lottie. |[CN][使用方法]( https://github.com/ChenYilong/CYLTabBarController/issues/341) </p> [EN][How to add animation of Lottie with one line of code.]( https://github.com/ChenYilong/CYLTabBarController/issues/341) </p>  </p> 
|
|||
|
|
[CN]低耦合，易删除</p>[EN]Loose coupling | [CN]1、TabBar设置与业务完全分离，最低只需传两个数组即可完成主流App框架搭建。</p>[EN]1. This library is independent of your business codes which only needs two array parameters to be passed. </p> [CN]2、 PlusButton 的所有设置都在单独的一个类（ `CYLPlusButton` 的子类）中实现：删除该特定的类，就能完全将 PlusButton 从项目中删除掉。</p>[EN]2.PlusButton is also independent. If you delete the code of this class, you remove the PlusButton feature from your UI on screen completely.
|
|||
|
|
[CN]`TabBar` 以及 `TabBar` 内的 `TabBarItem` 均使用系统原生的控件</p>[EN]`TabBar` and `TabBarItem` those parts of this library both are system objects. | [CN]因为使用原生的控件，并非 `UIButton` 或 `UIView` 。好处如下：</p>[EN]Advantages of quitting choosing `UIButton` or `UIView`: </p> 1. 无需反复调“间距位置等”来接近系统效果。</p>[EN]There is not need to adjust those object to make them close to a system object appearance. </p> 2. 在push到下一页时 `TabBar` 的隐藏和显示之间的过渡效果跟系统一致（详见“ [集成后的效果](https://github.com/ChenYilong/CYLTabBarController#集成后的效果) ”部分，给出了效果图）</p>[EN]2. A push animation is same to a system objects appearance. </p> 3. 原生控件，所以可以使用诸多系统API，比如：可以使用 ` [UITabBar appearance];` 、` [UITabBarItem appearance];` 设置样式。（详见“[补充说明](https://github.com/ChenYilong/CYLTabBarController#补充说明) ”部分，给出了响应代码示例）</p>[EN]3.It is convenient to use the system API such as ` [UITabBar appearance];`,` [UITabBarItem appearance];`, etc.
|
|||
|
|
自动监测是否需要添加“加号”按钮，</p>并能自动设置位置</p>[EN] It is able to check if need to add a PlusButton automatically. |[CYLTabBarController](https://github.com/ChenYilong/CYLTabBarController) 既支持类似微信的“中规中矩”的 `TabBarController` 样式，并且默认就是微信这种样式，同时又支持类似“微博”或“淘宝闲鱼”这种具有不规则加号按钮的 `TabBarController` 。想支持这种样式，只需自定义一个加号按钮，[CYLTabBarController](https://github.com/ChenYilong/CYLTabBarController) 能检测到它的存在并自动将 `tabBar` 排序好，无需多余操作，并且也预留了一定接口来满足自定义需求。</p>“加号”按钮的样式、frame均在自定义的类中独立实现，不会涉及tabbar相关设置。
|
|||
|
|
支持动态更新 | 可动态删除PlusButton ，可以动态更新样式 </p> 
|
|||
|
|
即使加号按钮超出了tabbar的区域，</p>超出部分依然能响应点击事件 | 红线内的区域均能响应tabbar相关的点击事件，</p>
|
|||
|
|
允许指定加号按钮位置 | 效果如下：</p> </p>Airbnb-app效果：</p>
|
|||
|
|
支持让 `TabBarItem` 仅显示图标，并自动使图标垂直居中，支持自定义TabBar高度 | 效果可见Airbnb-app效果，或者下图</p>
|
|||
|
|
支持角标自定义View | 
|
|||
|
|
支持多TabBar嵌套，并指定PlusButton位置 | 
|
|||
|
|
支持CocoaPods |容易集成
|
|||
|
|
支持Swift项目导入 | 兼容
|
|||
|
|
支持横竖屏 | －－
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
（学习交流群：515295083）
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 集成后的效果：
|
|||
|
|
既支持默认样式 | 同时也支持创建自定义的形状不规则加号按钮
|
|||
|
|
-------------|------------
|
|||
|
|
| 
|
|||
|
|
|
|||
|
|
|
|||
|
|
支持横竖屏
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6us68c57ig30fe0ggwj3.gif"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
本仓库配套Demo的效果：| [另一个Demo](https://github.com/ChenYilong/CYLTabBarControllerDemoForWeib) </p> 使用CYLTabBarController实现了微博Tabbar框架，</p>效果如下
|
|||
|
|
-------------|-------------
|
|||
|
|
 | 
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
做下说明：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
|
|||
|
|
├── CYLTabBarController ＃核心库文件夹，如果不使用 CocoaPods 集成，请直接将这个文件夹拖拽带你的项目中
|
|||
|
|
└── Example
|
|||
|
|
└── Classes
|
|||
|
|
├── Module #模块类文件夹
|
|||
|
|
│ ├── Home
|
|||
|
|
│ ├── Message
|
|||
|
|
│ ├── Mine
|
|||
|
|
│ └── SameCity
|
|||
|
|
└── View #这里放着 CYLPlusButton 的子类 CYLPlusButtonSubclass，演示了如何创建自定义的形状不规则加号按钮
|
|||
|
|
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 使用[CYLTabBarController](https://github.com/ChenYilong/CYLTabBarController)
|
|||
|
|
|
|||
|
|
四步完成主流App框架搭建：
|
|||
|
|
|
|||
|
|
1. [ 第一步：使用CocoaPods导入CYLTabBarController ](https://github.com/ChenYilong/CYLTabBarController#第一步使用cocoapods导入cyltabbarcontroller)
|
|||
|
|
2. [第二步：设置CYLTabBarController的两个数组：控制器数组和TabBar属性数组](https://github.com/ChenYilong/CYLTabBarController#第二步设置cyltabbarcontroller的两个数组控制器数组和tabbar属性数组)
|
|||
|
|
3. [第三步：将CYLTabBarController设置为window的RootViewController](https://github.com/ChenYilong/CYLTabBarController#第三步将cyltabbarcontroller设置为window的rootviewcontroller)
|
|||
|
|
4. [第四步（可选）：创建自定义的形状不规则加号按钮](https://github.com/ChenYilong/CYLTabBarController#第四步可选创建自定义的形状不规则加号按钮)
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 第一步：使用CocoaPods导入CYLTabBarController
|
|||
|
|
|
|||
|
|
1. CocoaPods 安装
|
|||
|
|
|
|||
|
|
如果您的机器上已经安装了 CocoaPods，直接进入下一步即可。
|
|||
|
|
|
|||
|
|
如果您的网络已经翻墙，在终端中运行如下命令直接安装：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
sudo gem install cocoapods
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果您的网络不能翻墙，可以通过国内 Ruby China 的 RubyGems 镜像进行安装。
|
|||
|
|
|
|||
|
|
在终端依次运行以下命令：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
|
|||
|
|
|
|||
|
|
sudo gem install cocoapods
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. 查询 CocoaPods 源中的本库
|
|||
|
|
|
|||
|
|
在终端中运行以下命令：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod search CYLTabBarController
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这里注意，这个命令搜索的是本机上的最新版本，并没有联网查询。如果运行以上命令，没有搜到或者搜不到最新版本，您可以运行以下命令，更新一下您本地的 CocoaPods 源列表。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod repo update
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. 使用 CocoaPods 导入
|
|||
|
|
|
|||
|
|
打开终端，进入到您的工程目录，执行以下命令，会自动生成一个 Podfile 文件。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod init
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后使用 CocoaPods 进行安装。如果尚未安装 CocoaPods，运行以下命令进行安装：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
gem install cocoapods
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
打开 Podfile，在您项目的 target 下加入以下内容。（此处示例可能是旧版本，使用时请替换为最新版，最新版信息可以从这里获取：<a href="https://github.com/ChenYilong/CYLTabBarController/blob/master/CYLTabBarController.podspec"><img src="https://img.shields.io/badge/Pod-GetLatestVersion-green.svg?style=flat"></a>）
|
|||
|
|
|
|||
|
|
在文件 `Podfile` 中加入以下内容：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod 'CYLTabBarController', '~> 1.24.0'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后在终端中运行以下命令：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或者这个命令：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# 禁止升级 CocoaPods 的 spec 仓库，否则会卡在 Analyzing dependencies，非常慢
|
|||
|
|
pod update --verbose --no-repo-update
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果提示找不到库，则可去掉 `--no-repo-update`。
|
|||
|
|
|
|||
|
|
完成后1.24.0，CocoaPods 会在您的工程根目录下生成一个 `.xcworkspace` 文件。您需要通过此文件打开您的工程，而不是之前的 `.xcodeproj`。
|
|||
|
|
|
|||
|
|
**CocoaPods 使用说明**
|
|||
|
|
|
|||
|
|
**指定 CYLTabBarController 版本**
|
|||
|
|
|
|||
|
|
CocoaPods 中，有几种设置 CYLTabBarController 版本的方法。如：
|
|||
|
|
|
|||
|
|
`>= 1.n.X` 会根据您本地的 CocoaPods 源列表，导入不低于 `1.(n+1).X` 版本的 CYLTabBarController。
|
|||
|
|
|
|||
|
|
`~> 1.n.X` 会根据您本地的 CocoaPods 源列表，介于 1.n.X~1.(n+1).0 之前版本的 CYLTabBarController。
|
|||
|
|
|
|||
|
|
建议选择后者：锁定版本，便于团队开发。如：
|
|||
|
|
|
|||
|
|
（此处示例可能是旧版本，使用时请替换为最新版，最新版信息可以从这里获取：<a href="https://github.com/ChenYilong/CYLTabBarController/blob/master/CYLTabBarController.podspec"><img src="https://img.shields.io/badge/Pod-GetLatestVersion-green.svg?style=flat"></a>）
|
|||
|
|
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod 'CYLTabBarController', '~> 1.24.0'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 升级本地 CocoaPods 源
|
|||
|
|
|
|||
|
|
`CocoaPods 有一个中心化的源，默认本地会缓存 CocoaPods 源服务器上的所有 CYLTabBarController 版本。
|
|||
|
|
|
|||
|
|
如果搜索的时候没有搜到或者搜不到最新版本，可以执行以下命令更新一下本地的缓存。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod repo update
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- 升级工程的 CYLTabBarController 版本
|
|||
|
|
|
|||
|
|
更新您工程目录中 Podfile 指定的 CYLTabBarController 版本后，在终端中执行以下命令。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pod update
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 清除 Cocoapods 本地缓存
|
|||
|
|
|
|||
|
|
特殊情况下，由于网络或者别的原因，通过 CocoaPods 下载的文件可能会有问题。
|
|||
|
|
|
|||
|
|
这时候您可以删除 CocoaPods 的缓存(~/Library/Caches/CocoaPods/Pods/Release 目录)，再次导入即可。
|
|||
|
|
|
|||
|
|
- 查看当前使用的 CYLTabBarController 版本
|
|||
|
|
|
|||
|
|
您可以在 Podfile.lock 文件中看到您工程中使用的 CYLTabBarController 版本。
|
|||
|
|
|
|||
|
|
关于 CocoaPods 的更多内容，您可以参考 [CocoaPods 文档](https://cocoapods.org/)。
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 第二步：设置CYLTabBarController的两个数组：控制器数组和TabBar属性数组
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//MainTabBarController
|
|||
|
|
|
|||
|
|
@interface MainTabBarController : CYLTabBarController
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
|
|||
|
|
- (instancetype)init {
|
|||
|
|
if (!(self = [super init])) {
|
|||
|
|
return nil;
|
|||
|
|
}
|
|||
|
|
/**
|
|||
|
|
* 以下两行代码目的在于手动设置让TabBarItem只显示图标，不显示文字，并让图标垂直居中。
|
|||
|
|
* 等效于在 `-tabBarItemsAttributesForController` 方法中不传 `CYLTabBarItemTitle` 字段。
|
|||
|
|
* 更推荐后一种做法。
|
|||
|
|
*/
|
|||
|
|
UIEdgeInsets imageInsets = UIEdgeInsetsZero;//UIEdgeInsetsMake(4.5, 0, -4.5, 0);
|
|||
|
|
UIOffset titlePositionAdjustment = UIOffsetMake(0, -3.5);
|
|||
|
|
CYLTabBarController *tabBarController = [CYLTabBarController tabBarControllerWithViewControllers:self.viewControllers
|
|||
|
|
tabBarItemsAttributes:self.tabBarItemsAttributesForController
|
|||
|
|
imageInsets:imageInsets
|
|||
|
|
titlePositionAdjustment:titlePositionAdjustment
|
|||
|
|
context:nil
|
|||
|
|
];
|
|||
|
|
[self customizeTabBarAppearance:tabBarController];
|
|||
|
|
self.navigationController.navigationBar.hidden = YES;
|
|||
|
|
return (self = (MainTabBarController *)tabBarController);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
- (NSArray *)viewControllers {
|
|||
|
|
CYLHomeViewController *firstViewController = [[CYLHomeViewController alloc] init];
|
|||
|
|
UIViewController *firstNavigationController = [[CYLBaseNavigationController alloc]
|
|||
|
|
initWithRootViewController:firstViewController];
|
|||
|
|
[firstViewController cyl_setHideNavigationBarSeparator:YES];
|
|||
|
|
CYLSameCityViewController *secondViewController = [[CYLSameCityViewController alloc] init];
|
|||
|
|
UIViewController *secondNavigationController = [[CYLBaseNavigationController alloc]
|
|||
|
|
initWithRootViewController:secondViewController];
|
|||
|
|
[secondViewController cyl_setHideNavigationBarSeparator:YES];
|
|||
|
|
NSArray *viewControllers = @[
|
|||
|
|
firstNavigationController,
|
|||
|
|
secondNavigationController,
|
|||
|
|
];
|
|||
|
|
return viewControllers;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
- (NSArray *)tabBarItemsAttributesForController {
|
|||
|
|
NSDictionary *firstTabBarItemsAttributes = @{
|
|||
|
|
CYLTabBarItemTitle : @"首页",
|
|||
|
|
CYLTabBarItemImage : self.darkMode ? @"home_highlight" : @"home_normal", /* NSString and UIImage are supported*/
|
|||
|
|
CYLTabBarItemSelectedImage : @"home_highlight", /* NSString and UIImage are supported*/
|
|||
|
|
};
|
|||
|
|
NSDictionary *secondTabBarItemsAttributes = @{
|
|||
|
|
CYLTabBarItemTitle : @"鱼塘",
|
|||
|
|
CYLTabBarItemImage : self.darkMode ? @"fishpond_highlight" : @"fishpond_normal",
|
|||
|
|
CYLTabBarItemSelectedImage : @"fishpond_highlight",
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
NSArray *tabBarItemsAttributes = @[
|
|||
|
|
firstTabBarItemsAttributes,
|
|||
|
|
secondTabBarItemsAttributes,
|
|||
|
|
];
|
|||
|
|
return tabBarItemsAttributes;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在这个字典中，`CYLTabBarItemImage` 和 `CYLTabBarItemSelectedImage` 支持 `NSString`、`UIImage`
|
|||
|
|
两种格式。`CYLTabBarItemTitle` 不设置将只展示图标，并会对布局作出居中处理。
|
|||
|
|
|
|||
|
|
### 第三步：将CYLTabBarController设置为window的RootViewController
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|||
|
|
/* *省略部分： * */
|
|||
|
|
[self.window setRootViewController:self.tabBarController];
|
|||
|
|
/* *省略部分： * */
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或者将 CYLTabBarController 的子类设为 RootViewCOntroller ，也可以将CYLTabBarController子类的 NavigationViewController 作为 RootViewCOntroller，方便动态更新，Demo 中就是采用后者。
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 第四步（可选）：创建自定义的形状不规则加号按钮
|
|||
|
|
|
|||
|
|
|
|||
|
|
创建一个继承于 CYLPlusButton 的类，要求和步骤：
|
|||
|
|
|
|||
|
|
|
|||
|
|
1. 实现 `CYLPlusButtonSubclassing` 协议
|
|||
|
|
|
|||
|
|
2. 子类将自身类型进行注册：调用 `[YourClass registerPlusButton]`，需要在 RootViewCOntroller 的 ViewDidLoad 中注册，也可以在 `-application:didFinishLaunchingWithOptions:` 方法里面操作。
|
|||
|
|
|
|||
|
|
这里注意，不建议在子类的 `+load` 方法中调用，比如像下面这样做，在 iOS10 系统上有 Crash 的风险：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (void)load {
|
|||
|
|
[super registerPlusButton];
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
协议提供了可选方法：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (NSUInteger)indexOfPlusButtonInTabBar;
|
|||
|
|
+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;
|
|||
|
|
+ (UIViewController *)plusChildViewController;
|
|||
|
|
+ (BOOL)shouldSelectPlusChildViewController;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
作用分别是：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (NSUInteger)indexOfPlusButtonInTabBar;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
用来自定义加号按钮的位置，如果不实现默认居中，但是如果 `tabbar` 的个数是奇数则必须实现该方法，否则 `CYLTabBarController` 会抛出 `exception` 来进行提示。
|
|||
|
|
|
|||
|
|
主要适用于如下情景：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6gy1g92nics1hvj30a906u3ym.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
Airbnb-app效果：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6gy1g92nir57tmg308w0fsapi.gif"></a></p>
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
该方法是为了调整自定义按钮中心点Y轴方向的位置，建议在按钮超出了 `tabbar` 的边界时实现该方法。返回值是自定义按钮中心点Y轴方向的坐标除以 `tabbar` 的高度，如果不实现，会自动进行比对，预设一个较为合适的位置，如果实现了该方法，预设的逻辑将失效。
|
|||
|
|
|
|||
|
|
内部实现时，会使用该返回值来设置 PlusButton 的 centerY 坐标，公式如下：
|
|||
|
|
|
|||
|
|
`PlusButtonCenterY = multiplierOfTabBarHeight * taBarHeight + constantOfPlusButtonCenterYOffset;`
|
|||
|
|
|
|||
|
|
也就是说：如果 constantOfPlusButtonCenterYOffset 为0，同时 multiplierOfTabBarHeight 的值是0.5，表示 PlusButton 居中，小于0.5表示 PlusButton 偏上，大于0.5则表示偏下。
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
参考 `+multiplierOfTabBarHeight:` 中的公式：
|
|||
|
|
|
|||
|
|
`PlusButtonCenterY = multiplierOfTabBarHeight * taBarHeight + constantOfPlusButtonCenterYOffset;`
|
|||
|
|
|
|||
|
|
也就是说： constantOfPlusButtonCenterYOffset 大于0会向下偏移，小于0会向上偏移。
|
|||
|
|
|
|||
|
|
注意：实现了该方法，但没有实现 `+multiplierOfTabBarHeight:` 方法，在这种情况下，会在预设逻辑的基础上进行偏移。
|
|||
|
|
|
|||
|
|
详见Demo中的 `CYLPlusButtonSubclass` 类的实现。
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (UIViewController *)plusChildViewController;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
详见： [点击 PlusButton 跳转到指定 UIViewController](https://github.com/ChenYilong/CYLTabBarController#点击-plusbutton-跳转到指定-uiviewcontroller)
|
|||
|
|
|
|||
|
|
|
|||
|
|
另外，如果加号按钮超出了边界，一般需要手动调用如下代码取消 tabbar 顶部默认的阴影，可在 AppDelegate 类中调用：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//去除 TabBar 自带的顶部阴影
|
|||
|
|
[[UITabBar appearance] setShadowImage:[[UIImage alloc] init]];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
// iOS10 后 需要使用 `-[CYLTabBarController hideTabBarShadowImageView]` 见 AppDelegate 类中的演示;
|
|||
|
|
|
|||
|
|
如何调整、自定义 `PlusButton` 与其它 `TabBarItem` 的宽度？
|
|||
|
|
|
|||
|
|
`CYLTabBarController` 规定：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
TabBarItem 宽度 ＝ ( TabBar 总宽度 － PlusButton 宽度 ) / (TabBarItem 个数)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
所以想自定义宽度，只需要修改 `PlusButton` 的宽度即可。
|
|||
|
|
|
|||
|
|
比如你就可以在 Demo中的 `CYLPlusButtonSubclass.m` 类里：
|
|||
|
|
|
|||
|
|
把
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
[button sizeToFit];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
改为
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
button.frame = CGRectMake(0.0, 0.0, 250, 100);
|
|||
|
|
button.backgroundColor = [UIColor redColor];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
效果如下，
|
|||
|
|
1.24.0
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6ur17yxa3j30yi0c6abk.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
同时你也可以顺便测试下 `CYLTabBarController` 的这一个特性：
|
|||
|
|
|
|||
|
|
> 即使加号按钮超出了tabbar的区域，超出部分依然能响应点击事件
|
|||
|
|
|
|||
|
|
并且你可以在项目中的任意位置读取到 `PlusButton` 的宽度，借助 `CYLTabBarController.h` 定义的 `CYLPlusButtonWidth` 这个extern。可参考 `+[CYLTabBarControllerConfig customizeTabBarAppearance:]` 里的用法。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 补充说明
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 自定义 `TabBar` 样式
|
|||
|
|
|
|||
|
|
如果想更进一步的自定义 `TabBar` 样式可在 `-application:didFinishLaunchingWithOptions:` 方法中设置
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
/**
|
|||
|
|
* tabBarItem 的选中和不选中文字属性、背景图片
|
|||
|
|
*/
|
|||
|
|
- (void)customizeInterface {
|
|||
|
|
|
|||
|
|
// 普通状态下的文字属性
|
|||
|
|
NSMutableDictionary *normalAttrs = [NSMutableDictionary dictionary];
|
|||
|
|
normalAttrs[NSForegroundColorAttributeName] = [UIColor grayColor];
|
|||
|
|
|
|||
|
|
// 选中状态下的文字属性
|
|||
|
|
NSMutableDictionary *selectedAttrs = [NSMutableDictionary dictionary];
|
|||
|
|
selectedAttrs[NSForegroundColorAttributeName] = [UIColor darkGrayColor];
|
|||
|
|
|
|||
|
|
// 设置文字属性
|
|||
|
|
UITabBarItem *tabBar = [UITabBarItem appearance];
|
|||
|
|
[tabBar setTitleTextAttributes:normalAttrs forState:UIControlStateNormal];
|
|||
|
|
[tabBar setTitleTextAttributes:selectedAttrs forState:UIControlStateSelected];
|
|||
|
|
|
|||
|
|
// 设置背景图片
|
|||
|
|
UITabBar *tabBarAppearance = [UITabBar appearance];
|
|||
|
|
[tabBarAppearance setBackgroundImage:[UIImage imageNamed:@"tabbar_background"]];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|||
|
|
/* *省略部分： * */
|
|||
|
|
[self.window makeKeyAndVisible];
|
|||
|
|
[self customizeInterface];
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 捕获 TabBar 点击事件
|
|||
|
|
|
|||
|
|
实现 CYLTabBarController 的如下几个代理方法即可捕获点击事件。
|
|||
|
|
|
|||
|
|
下面这个方法能捕获当前点击的 `TabBar` 上的控件，可以是 `UITabBarButton`、也可以 `PlusButton`、也可以是添加到 `TabBar` 上的任意 `UIControl` 的子类。但是如果 `PlusButton` 也添加了点击事件，那么点击 `PlusButton` 将不会被触发这个代理方法。
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//CYLTabBarController.h
|
|||
|
|
|
|||
|
|
@protocol CYLTabBarControllerDelegate <NSObject>
|
|||
|
|
|
|||
|
|
/*!
|
|||
|
|
* @param tabBarController The tab bar controller containing viewController.
|
|||
|
|
* @param control Selected UIControl in TabBar.
|
|||
|
|
* @attention If PlusButton also add an action, then this delegate method will not be invoked when the PlusButton is selected.
|
|||
|
|
*/
|
|||
|
|
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
下面这个方法能捕获跳转前所在的控制器，以及跳转到的目标控制器。
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//UITabBarController.h
|
|||
|
|
@protocol UITabBarControllerDelegate <NSObject>
|
|||
|
|
@optional
|
|||
|
|
- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController NS_AVAILABLE_IOS(3_0);
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
注意：在调用该方法时应该始终调用
|
|||
|
|
` [[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];` 来确保 `PlusButton` 的选中状态。示例如下：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
|
|||
|
|
[[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
相关用法已经在 Demo 中展示。
|
|||
|
|
|
|||
|
|
遵循协议的方式如下：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
@interface AppDelegate ()<UITabBarControllerDelegate, CYLTabBarControllerDelegate>
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|||
|
|
//...
|
|||
|
|
tabBarControllerConfig.tabBarController.delegate = self;
|
|||
|
|
//...
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 点击 TabBarButton 时添加动画
|
|||
|
|
|
|||
|
|
Demo 演示的效果图：
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://ww1.sinaimg.cn/large/006tNbRwly1fg9hu6qnwbg308v0gctcc.gif"></a></p>
|
|||
|
|
|
|||
|
|
实现如下代理方法，就能得到对应的选中控件，可以在控件上直接添加动画。
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//CYLTabBarController.h
|
|||
|
|
|
|||
|
|
@protocol CYLTabBarControllerDelegate <NSObject>
|
|||
|
|
|
|||
|
|
/*!
|
|||
|
|
* @param tabBarController The tab bar controller containing viewController.
|
|||
|
|
* @param control Selected UIControl in TabBar.
|
|||
|
|
*/
|
|||
|
|
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Demo 中示例代码如下：
|
|||
|
|
|
|||
|
|
遵循协议
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
@interface AppDelegate ()<UITabBarControllerDelegate, CYLTabBarControllerDelegate>
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//AppDelegate.m
|
|||
|
|
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control {
|
|||
|
|
UIView *animationView;
|
|||
|
|
// 如果 PlusButton 也添加了点击事件，那么点击 PlusButton 后不会触发该代理方法。
|
|||
|
|
if ([control isKindOfClass:[CYLExternPlusButton class]]) {
|
|||
|
|
UIButton *button = CYLExternPlusButton;
|
|||
|
|
animationView = button.imageView;
|
|||
|
|
} else if ([control isKindOfClass:NSClassFromString(@"UITabBarButton")]) {
|
|||
|
|
for (UIView *subView in control.subviews) {
|
|||
|
|
if ([subView isKindOfClass:NSClassFromString(@"UITabBarSwappableImageView")]) {
|
|||
|
|
animationView = subView;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if ([self cyl_tabBarController].selectedIndex % 2 == 0) {
|
|||
|
|
[self addScaleAnimationOnView:animationView];
|
|||
|
|
} else {
|
|||
|
|
[self addRotateAnimationOnView:animationView];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//缩放动画
|
|||
|
|
- (void)addScaleAnimationOnView:(UIView *)animationView {
|
|||
|
|
//需要实现的帧动画，这里根据需求自定义
|
|||
|
|
CAKeyframeAnimation *animation = [CAKeyframeAnimation animation];
|
|||
|
|
animation.keyPath = @"transform.scale";
|
|||
|
|
animation.values = @[@1.0,@1.3,@0.9,@1.15,@0.95,@1.02,@1.0];
|
|||
|
|
animation.duration = 1;
|
|||
|
|
animation.calculationMode = kCAAnimationCubic;
|
|||
|
|
[animationView.layer addAnimation:animation forKey:nil];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//旋转动画
|
|||
|
|
- (void)addRotateAnimationOnView:(UIView *)animationView {
|
|||
|
|
[UIView animateWithDuration:0.32 delay:0 options:UIViewAnimationOptionCurveEaseIn animations:^{
|
|||
|
|
animationView.layer.transform = CATransform3DMakeRotation(M_PI, 0, 1, 0);
|
|||
|
|
} completion:nil];
|
|||
|
|
|
|||
|
|
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
|
|||
|
|
[UIView animateWithDuration:0.70 delay:0 usingSpringWithDamping:1 initialSpringVelocity:0.2 options:UIViewAnimationOptionCurveEaseOut animations:^{
|
|||
|
|
animationView.layer.transform = CATransform3DMakeRotation(2 * M_PI, 0, 1, 0);
|
|||
|
|
} completion:nil];
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 横竖屏适配
|
|||
|
|
|
|||
|
|
`TabBar` 横竖屏适配时，如果你添加了 `PlusButton`，且适配时用到了 `TabBarItem` 的宽度, 不建议使用系统的`UIDeviceOrientationDidChangeNotification` , 请使用库里的 `CYLTabBarItemWidthDidChangeNotification` 来更新 `TabBar` 布局，最典型的场景就是，根据 `TabBarItem` 在不同横竖屏状态下的宽度变化来切换选中的`TabBarItem` 的背景图片。Demo 里 `CYLTabBarControllerConfig.m` 给出了这一场景的用法:
|
|||
|
|
|
|||
|
|
|
|||
|
|
`CYLTabBarController.h` 中提供了 `CYLTabBarItemWidth` 这一extern常量，并且会在 `TabBarItem` 的宽度发生变化时，及时更新该值，所以用法就如下所示：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
- (void)updateTabBarCustomizationWhenTabBarItemWidthDidUpdate {
|
|||
|
|
void (^deviceOrientationDidChangeBlock)(NSNotification *) = ^(NSNotification *notification) {
|
|||
|
|
[self tabBarItemWidthDidUpdate];
|
|||
|
|
};
|
|||
|
|
[[NSNotificationCenter defaultCenter] addObserverForName:CYLTabBarItemWidthDidChangeNotification
|
|||
|
|
object:nil
|
|||
|
|
queue:[NSOperationQueue mainQueue]
|
|||
|
|
usingBlock:deviceOrientationDidChangeBlock];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
- (void)tabBarItemWidthDidUpdate {
|
|||
|
|
UIDeviceOrientation orientation = [[UIDevice currentDevice] orientation];
|
|||
|
|
if ((orientation == UIDeviceOrientationLandscapeLeft) || (orientation == UIDeviceOrientationLandscapeRight)) {
|
|||
|
|
NSLog(@"Landscape Left or Right !");
|
|||
|
|
} else if (orientation == UIDeviceOrientationPortrait){
|
|||
|
|
NSLog(@"Landscape portrait!");
|
|||
|
|
}
|
|||
|
|
CGSize selectionIndicatorImageSize = CGSizeMake(CYLTabBarItemWidth, [self cyl_tabBarController].tabBar.bounds.size.height);
|
|||
|
|
[[self cyl_tabBarController].tabBar setSelectionIndicatorImage:[[self class]
|
|||
|
|
imageFromColor:[UIColor yellowColor]
|
|||
|
|
forSize:selectionIndicatorImageSize
|
|||
|
|
withCornerRadius:0]];
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6us68c57ig30fe0ggwj3.gif"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 访问初始化好的 CYLTabBarController 对象
|
|||
|
|
|
|||
|
|
对于任意 `NSObject` 对象：
|
|||
|
|
|
|||
|
|
`CYLTabBarController.h` 中为 `NSObject` 提供了分类方法 `-cyl_tabBarController` ，所以在任意对象中，一行代码就可以访问到一个初始化好的 `CYLTabBarController` 对象，`-cyl_tabBarController` 的作用你可以这样理解：与获取单例对象的 `+shareInstance` 方法作用一样。
|
|||
|
|
|
|||
|
|
接口如下：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
// CYLTabBarController.h
|
|||
|
|
|
|||
|
|
@interface NSObject (CYLTabBarController)
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* If `self` is kind of `UIViewController`, this method will return the nearest ancestor in the view controller hierarchy that is a tab bar controller. If `self` is not kind of `UIViewController`, it will return the `rootViewController` of the `rootWindow` as long as you have set the `CYLTabBarController` as the `rootViewController`. Otherwise return nil. (read-only)
|
|||
|
|
*/
|
|||
|
|
@property (nonatomic, readonly) CYLTabBarController *cyl_tabBarController;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
用法：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//导入 CYLTabBarController.h
|
|||
|
|
#import "CYLTabBarController.h"
|
|||
|
|
|
|||
|
|
- (void)viewDidLoad {
|
|||
|
|
[super viewDidLoad];
|
|||
|
|
CYLTabBarController *tabbarController = [self cyl_tabBarController];
|
|||
|
|
/*...*/
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 点击 PlusButton 跳转到指定 UIViewController
|
|||
|
|
|
|||
|
|
提供了一个协议方法来完成本功能：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6urdwrhhjj30mx0gjq5r.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
实现该方法后，能让 PlusButton 的点击效果与跟点击其他 TabBar 按钮效果一样，跳转到该方法指定的 UIViewController 。
|
|||
|
|
|
|||
|
|
注意：必须同时实现 `+indexOfPlusButtonInTabBar` 来指定 PlusButton 的位置。
|
|||
|
|
|
|||
|
|
遵循几个协议：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
#pragma mark - CYLPlusButtonSubclassing
|
|||
|
|
|
|||
|
|
+ (UIViewController *)plusChildViewController {
|
|||
|
|
UIViewController *plusChildViewController = [[UIViewController alloc] init];
|
|||
|
|
plusChildViewController.view.backgroundColor = [UIColor redColor];
|
|||
|
|
plusChildViewController.navigationItem.title = @"PlusChildViewController";
|
|||
|
|
UIViewController *plusChildNavigationController = [[UINavigationController alloc]
|
|||
|
|
initWithRootViewController:plusChildViewController];
|
|||
|
|
return plusChildNavigationController;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
+ (NSUInteger)indexOfPlusButtonInTabBar {
|
|||
|
|
return 2;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
+ (BOOL)shouldSelectPlusChildViewController {
|
|||
|
|
BOOL isSelected = CYLExternPlusButton.selected;
|
|||
|
|
if (isSelected) {
|
|||
|
|
// HDLLogDebug("🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is selected");
|
|||
|
|
} else {
|
|||
|
|
// HDLLogDebug("🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is not selected");
|
|||
|
|
}
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight {
|
|||
|
|
return 0.3;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
+ (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight {
|
|||
|
|
return (CYL_IS_IPHONE_X ? - 6 : 4);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//+ (NSString *)tabBarContext {
|
|||
|
|
// return NSStringFromClass([self class]);
|
|||
|
|
//}
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
另外你可以通过下面这个方法获取到 `PlusButton` 的点击事件：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (BOOL)shouldSelectPlusChildViewController;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
用法如下：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (BOOL)shouldSelectPlusChildViewController {
|
|||
|
|
BOOL isSelected = CYLExternPlusButton.selected;
|
|||
|
|
if (isSelected) {
|
|||
|
|
NSLog(@"🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is selected");
|
|||
|
|
} else {
|
|||
|
|
NSLog(@"🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is not selected");
|
|||
|
|
}
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 让TabBarItem仅显示图标，并使图标垂直居中
|
|||
|
|
|
|||
|
|
要想实现该效果，只需要在设置 `tabBarItemsAttributes`该属性时不传 title 即可。
|
|||
|
|
|
|||
|
|
比如：在Demo的基础上，注释掉图中红框部分：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6urbcuckkj30ly0erdil.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
注释前 | 注释后
|
|||
|
|
-------------|-------------
|
|||
|
|
|
|
|||
|
|
|
|||
|
|
可以通过这种方式来达到 Airbnb-app 的效果：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6gy1g92nir57tmg308w0fsapi.gif"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
如果想手动设置偏移量来达到该效果：
|
|||
|
|
可以在 `-setViewControllers:` 方法前设置 `CYLTabBarController` 的 `imageInsets` 和 `titlePositionAdjustment` 属性
|
|||
|
|
|
|||
|
|
这里注意：设置这两个属性后，`TabBar` 中所有的 `TabBarItem` 都将被设置。并且第一种做法的逻辑将不会执行，也就是说该做法优先级要高于第一种做法。
|
|||
|
|
|
|||
|
|
做法在demo中已经给出。
|
|||
|
|
|
|||
|
|
但是想达到Airbnb-app的效果只有这个接口是不行的，还需要自定义下 `TabBar` 的高度，你需要设置 `CYLTabBarController` 的 `tabBarHeight` 属性。你可以在Demo的 `CYLTabBarControllerConfig.m` 中的 `-customizeTabBarAppearance:` 方法中设置。
|
|||
|
|
|
|||
|
|
注：“仅显示图标，并使图标垂直居中”这里所指的“图标”，其所属的类是私有类： `UITabBarSwappableImageView`，所以 `CYLTabBarController` 在相关的接口命名时会包含 `SwappableImageView` 字样。另外，使用该特性需要 `pod update` 到 1.5.5以上的版本。
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 多TabBar嵌套，并指定PlusButton位置
|
|||
|
|
|
|||
|
|
该功能旧版本可能并不支持，建议更新最新版中使用。
|
|||
|
|
|
|||
|
|
效果图：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://ws4.sinaimg.cn/large/006tNc79ly1fmn3005isfg308r0iltl6.gif"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
实现 PlusButton 的如下协议方法指定 context：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//CYLPlusButtonSubclassing
|
|||
|
|
+ (NSString *)tabBarContext;
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
当该值与 TabBarController 的 context 能够匹配上，PlusButton 将会展示。如果 PlusButton 与 TabBarController 均未制定 context 值，那么默认 context 值是相等的。
|
|||
|
|
|
|||
|
|
目前仅支持一个 PlusButton 展示一次，不限层级。如果与多个 TabBarController 的 context 能够匹配上，仅展示在最先一次的匹配上的 TabBarController 上。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 在 Swift 项目中使用 CYLTabBarController
|
|||
|
|
|
|||
|
|
仓库中给出了一个Swift Demo，文件夹叫做 Example-Swift。
|
|||
|
|
|
|||
|
|
感谢[@WeMadeCode](https://github.com/WeMadeCode) 提供的 Swift 版 Demo，原仓库地址：[WeMadeCode/CYLTabBarController-Swift](https://github.com/WeMadeCode/CYLTabBarController-Swift)
|
|||
|
|
|
|||
|
|
具体的编写步骤参考热心网友提供的教程： [《从头开始swift2.1 仿搜材通项目（三） 主流框架Tabbed的搭建》]( http://www.jianshu.com/p/c5bc2eae0f55?nomobile=yes )
|
|||
|
|
|
|||
|
|
这里注意，文章的早期一个版本的示例代码有问题（笔者注：现在已经更新了），少了设置 PlusButton 大小的代码：
|
|||
|
|
这将导致 PlusButton 点击事件失效，具体修改代码如下：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6ur43ri5uj30ko0jmdjc.jpg"></a></p>
|
|||
|
|
|
|||
|
|
### 搭配 Storyboard 使用 CYLTabBarController
|
|||
|
|
|
|||
|
|
参考：
|
|||
|
|
|
|||
|
|
- 见这里 [issue讨论]( https://github.com/ChenYilong/CYLTabBarController/issues/170 )
|
|||
|
|
- [这里](https://github.com/ChenYilong/CYLDeallocBlockExecutor) ，里面有个文件夹CYLTabBarControllerTestDemo，这个Demo演示了如何搭配 Storyboard 使用。
|
|||
|
|
|
|||
|
|
### 源码实现原理
|
|||
|
|
|
|||
|
|
参考： [《[Note] CYLTabBarController》]( http://www.jianshu.com/p/8758d8014f86 )
|
|||
|
|
|
|||
|
|
更多文档信息可查看 [ ***CocoaDocs：CYLTabBarController*** ](http://cocoadocs.org/docsets/CYLTabBarController/1.2.1/index.html) 。
|
|||
|
|
|
|||
|
|
## FAQ
|
|||
|
|
|
|||
|
|
|
|||
|
|
更多Q-A内容，可以在这里查看： [issue-FAQ](https://github.com/ChenYilong/CYLTabBarController/issues?utf8=✓&q=+label%3AQ-A+)
|
|||
|
|
Q：为什么放置6个TabBarItem会显示异常？
|
|||
|
|
|
|||
|
|
A：
|
|||
|
|
|
|||
|
|
Apple 规定：
|
|||
|
|
|
|||
|
|
> 一个 `TabBar` 上只能出现最多5个 `TabBarItem` ，第六个及更多的将不被显示。
|
|||
|
|
|
|||
|
|
|
|||
|
|
另外注意，Apple检测的是 `UITabBarItem` 及其子类，所以放置“加号按钮”，这是 `UIButton` 不在“5个”里面。
|
|||
|
|
|
|||
|
|
最多只能添加5个 `TabBarItem` ，也就是说加上“加号按钮”，一共最多在一个 `TabBar` 上放置6个控件。否则第6个及之后出现 `TabBarItem` 会被自动屏蔽掉。而且就Apple的审核机制来说，超过5个也会被直接拒绝上架。
|
|||
|
|
|
|||
|
|
Q：我把 demo 两侧的 item 各去掉一个后，按钮的响应区域就变成下图的样子了：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://cloud.githubusercontent.com/assets/12152553/10725491/62600172-7c07-11e5-9e0a-0ec7d795d1e3.jpeg"></a></p>
|
|||
|
|
|
|||
|
|
A：v1.5.5 版本已经修复了该问题，现在不会出现类似的问题了：点击按钮区域却不响应，响应区域有偏移。
|
|||
|
|
|
|||
|
|
Q： 如何实现添加选中背景色的功能 ，像下面这样：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://cloud.githubusercontent.com/assets/7238866/10777333/5d7811c8-7d55-11e5-88be-8cb11bbeaf90.png"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
A：我已经在 Demo 中添加了如何实现该功能的代码：
|
|||
|
|
详情见 `CYLTabBarControllerConfig` 类中下面方法的实现：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
/**
|
|||
|
|
* 更多TabBar自定义设置：比如：tabBarItem 的选中和不选中文字和背景图片属性、tabbar 背景图片属性
|
|||
|
|
*/
|
|||
|
|
- (void)customizeTabBarAppearance:(CYLTabBarController *)tabBarController;
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
效果如下：
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://cloud.githubusercontent.com/assets/2911921/10779397/34956b0a-7d6b-11e5-82d9-fa75aa34e8d0.png"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Q: 当 `ViewController` 设置的 `self.title` 和 `tabBarItemsAttributes` 中对应的 `title` 不一致的时候，会出现如图的错误，排序不对了
|
|||
|
|
|
|||
|
|
A：在 v1.0.7 版本中已经修复了该 bug，但是也需要注意：
|
|||
|
|
|
|||
|
|
请勿使用 `self.title = @"同城"; ` 这种方式，请使用 `self.navigationItem.title = @"同城"; `
|
|||
|
|
|
|||
|
|
`self.title = @"同城"; ` 这种方式，如果和 `tabBarItemsAttributes` 中对应的 `title` 不一致的时候可能会导致如下现象（不算 bug，但看起来也很奇怪）：
|
|||
|
|
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6ur9yhnqej30ac01pq2z.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
规则如下：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
|
|||
|
|
self.navigationItem.title = @"同城"; //✅sets navigation bar title.The right way to set the title of the navigation
|
|||
|
|
self.tabBarItem.title = @"同城"; //❌sets tab bar title. Even the `tabBarItem.title` changed, this will be ignored in tabbar.
|
|||
|
|
self.title = @"同城1"; //❌sets both of these. Do not do this‼️‼️ This may cause something strange like this : http://i68.tinypic.com/282l3x4.jpg
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Q : 当使用这个方法时 `-[UIViewController cyl_popSelectTabBarChildViewControllerAtIndex:]` 系列方法时，会出现如下的黑边问题。
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6ur5d01x6j30af0ijmy6.jpg"></a></p>
|
|||
|
|
|
|||
|
|
A： 这个是 iOS 系统的BUG，经测试iOS9.3已经修复了，如果在更早起版本中出现了，可以通过下面将 `rootWindow` 的背景色改为白色来避免：比如你可以 `Appdelegate` 类里这样设置：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
//#import "CYLTabBarController.h"
|
|||
|
|
[[self cyl_tabBarController] rootWindow].backgroundColor = [UIColor whiteColor];
|
|||
|
|
```
|
|||
|
|
Q:我现在已经做好了一个比较简单的中间凸起的 icon 但是超过了49这个高度的位置是不能效应的 我想请问你的demo哪个功能是可以使我超出的范围也可以响应的呢?
|
|||
|
|
|
|||
|
|
A: 这个是自动做的，但是 `CYLTabBarController` 只能保证的是：只要是 `UIButton` 的 frame 区域内就能响应。
|
|||
|
|
|
|||
|
|
请把 button 的背景颜色设置为显眼的颜色，比如红色，比如像下面的plus按钮，红色部分是能接收点击事件的，但是超出了红色按钮的，黄色的图片区域，依然是无法响应点击事件的。
|
|||
|
|
|
|||
|
|
<p align="center"><a href="https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw"><img src="https://tva1.sinaimg.cn/large/006y8mN6ly1g6ur67tddnj30yi0c6abk.jpg"></a></p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
这是因为，在响应链上，`UIControl` 能响应点击事件， `UIImage` 无法响应。
|
|||
|
|
|
|||
|
|
|
|||
|
|
Q：为什么在iOS10上会Crash，iOS9上不会？
|
|||
|
|
|
|||
|
|
|
|||
|
|
A：
|
|||
|
|
在注册加号按钮时，需要在 `-application:didFinishLaunchingWithOptions:` 方法里面调用 `[YourClass registerPlusButton]`
|
|||
|
|
|
|||
|
|
这里注意，不能在子类的 `+load` 方法中调用，比如像下面这样做，在 iOS10 系统上有 Crash 的风险：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
+ (void)load {
|
|||
|
|
[super registerPlusButton];
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Q: 我的样式是点击 `plusButton` 后跳转到一个 `ViewController`，但是选中了一次中间的 `plusButton` 之后，再点别的 `tabItem` ，中间不会变成 `normal` 的状态。
|
|||
|
|
|
|||
|
|
A: 有两种情况会造成这个问题：
|
|||
|
|
|
|||
|
|
1. 应该是你的 `tabBar` 设置了 `delegate` 了，你要是 `tabBar` 的代理没设置的话，默认会有这个 `selected` 状态切换的处理。你设置代理后，会覆盖我的行为。所以手动加上就好了。
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
|
|||
|
|
[[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
|
|||
|
|
return YES;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. `plusButton` 添加了自定义点击事件或者自定义手势，因为这样会造成点击事件冲突或手势冲突，当需要 `pushViewController` 的时候，这个库会自动的添加点击事件，你这里重新加了点击事件所以冲突了；
|
|||
|
|
|
|||
|
|
在你项目的基础，把 `plusButton` 的点击事件取消掉,也就是 `addTarget` 这一行注释掉，手势事件也同理，应该就ok了
|
|||
|
|
|
|||
|
|
A: `PlusButton` 与其他的 `TabBarItem` 距离没有平均分布
|
|||
|
|
|
|||
|
|
(对应于 [issue#36](https://github.com/ChenYilong/CYLTabBarController/issues/36#issuecomment-269165471) )
|
|||
|
|
|
|||
|
|
把这 Demo 里的这一行代码改下：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
[button sizeToFit];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
改成：
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
button.frame = CGRectMake(0.0, 0.0, w, h);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
那么如果单是放一个照相机的图片，一般是多大的尺寸？
|
|||
|
|
|
|||
|
|
这个要看设计图，通常情况下，你可以写死与其他TabBarItem一样大小：
|
|||
|
|
|
|||
|
|
|
|||
|
|
```Objective-C
|
|||
|
|
[UIScreen mainScreen].bounds.size.width / [CYLTabBarController allItemsInTabBarCount]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
Q：如何兼容 Lottie 动画？
|
|||
|
|
A：用法见：https://github.com/ChenYilong/CYLTabBarController/issues/341
|
|||
|
|
|
|||
|
|
|
|||
|
|
（更多iOS开发干货，欢迎关注 [微博@iOS程序犭袁](http://weibo.com/luohanchenyilong/) ）
|
|||
|
|
|
|||
|
|
|
|||
|
|
--------------------------------------------
|
|||
|
|
|
|||
|
|
|
|||
|
|
Posted by Posted by [微博@iOS程序犭袁](http://weibo.com/luohanchenyilong/) & [公众号@iTeaTime技术清谈](https://mp.weixin.qq.com/s/A4e5h3xgIEh6PInf1Rjqsw)
|
|||
|
|
原创作品，版权声明：License MIT
|
|||
|
|
<p align="center"><a href="http://weibo.com/u/1692391497?s=6uyXnP" target="_blank"><img border="0" src="http://service.t.sina.com.cn/widget/qmd/1692391497/b46c844b/1.png"/></a></p>
|
|||
|
|
|
|||
|
|
|