| New file |
| | |
|---|
| | | // |
|---|
| | | // CYLPlusButton.h |
|---|
| | | // CYLTabBarController |
|---|
| | | // |
|---|
| | | // v1.16.0 Created by 微博@iOS程序犭袁 ( http://weibo.com/luohanchenyilong/ ) on 10/20/15. |
|---|
| | | // Copyright © 2015 https://github.com/ChenYilong . All rights reserved. |
|---|
| | | // |
|---|
| | | |
|---|
| | | #import <UIKit/UIKit.h> |
|---|
| | | |
|---|
| | | #import "CYLConstants.h" |
|---|
| | | @class CYLPlusButton; |
|---|
| | | |
|---|
| | | @protocol CYLPlusButtonSubclassing |
|---|
| | | |
|---|
| | | @required |
|---|
| | | + (id)plusButton; |
|---|
| | | @optional |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | * 用来自定义加号按钮的位置，如果不实现默认居中。 |
|---|
| | | * @attention 以下两种情况下，必须实现该协议方法，否则 CYLTabBarController 会抛出 exception 来进行提示： |
|---|
| | | 1. 添加了 PlusButton 且 TabBarItem 的个数是奇数。 |
|---|
| | | 2. 实现了 `+plusChildViewController`。 |
|---|
| | | * @return 用来自定义加号按钮在 TabBar 中的位置。 |
|---|
| | | * |
|---|
| | | */ |
|---|
| | | + (NSUInteger)indexOfPlusButtonInTabBar; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | * 该方法是为了调整 PlusButton 中心点Y轴方向的位置，建议在按钮超出了 tabbar 的边界时实现该方法。 |
|---|
| | | * @attention 如果不实现该方法，内部会自动进行比对，预设一个较为合适的位置，如果实现了该方法，预设的逻辑将失效。 |
|---|
| | | * @return 返回值是自定义按钮中心点Y轴方向的坐标除以 tabbar 的高度， |
|---|
| | | 内部实现时，会使用该返回值来设置 PlusButton 的 centerY 坐标，公式如下： |
|---|
| | | `PlusButtonCenterY = multiplierOfTabBarHeight * tabBarHeight + constantOfPlusButtonCenterYOffset;` |
|---|
| | | 也就是说：如果 constantOfPlusButtonCenterYOffset 为0，同时 multiplierOfTabBarHeight 的值是0.5，表示 PlusButton 居中，小于0.5表示 PlusButton 偏上，大于0.5则表示偏下。 |
|---|
| | | * |
|---|
| | | */ |
|---|
| | | + (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | * 见 `+multiplierOfTabBarHeight:` 注释： |
|---|
| | | * `PlusButtonCenterY = multiplierOfTabBarHeight * tabBarHeight + constantOfPlusButtonCenterYOffset;` |
|---|
| | | * 也就是说： constantOfPlusButtonCenterYOffset 大于0会向下偏移，小于0会向上偏移。 |
|---|
| | | * @attention 实现了该方法，但没有实现 `+multiplierOfTabBarHeight:` 方法，在这种情况下，会在预设逻辑的基础上进行偏移。 |
|---|
| | | */ |
|---|
| | | + (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | * 实现该方法后，能让 PlusButton 的点击效果与跟点击其他 TabBar 按钮效果一样，跳转到该方法指定的 UIViewController 。 |
|---|
| | | * @attention 必须同时实现 `+indexOfPlusButtonInTabBar` 来指定 PlusButton 的位置。 |
|---|
| | | * @return 指定 PlusButton 点击后跳转的 UIViewController。 |
|---|
| | | * |
|---|
| | | */ |
|---|
| | | + (UIViewController *)plusChildViewController; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | * |
|---|
| | | Asks the delegate whether the specified view controller should be made active. |
|---|
| | | Return YES if the view controller’s tab should be selected or NO if the current tab should remain active. |
|---|
| | | Returns YES true if the view controller’s tab should be selected or |
|---|
| | | NO false if the current tab should remain active. |
|---|
| | | */ |
|---|
| | | + (BOOL)shouldSelectPlusChildViewController; |
|---|
| | | |
|---|
| | | #pragma mark - Deprecated API |
|---|
| | | |
|---|
| | | + (CGFloat)multiplerInCenterY CYL_DEPRECATED("Deprecated in 1.6.0. Use `+multiplierOfTabBarHeight:` instead."); |
|---|
| | | |
|---|
| | | + (NSString *)tabBarContext; |
|---|
| | | |
|---|
| | | @end |
|---|
| | | |
|---|
| | | @class CYLTabBar; |
|---|
| | | |
|---|
| | | FOUNDATION_EXTERN UIButton<CYLPlusButtonSubclassing> *CYLExternPlusButton; |
|---|
| | | FOUNDATION_EXTERN UIViewController *CYLPlusChildViewController; |
|---|
| | | |
|---|
| | | @interface CYLPlusButton : UIButton |
|---|
| | | |
|---|
| | | + (void)registerPlusButton; |
|---|
| | | |
|---|
| | | - (void)plusChildViewControllerButtonClicked:(UIButton<CYLPlusButtonSubclassing> *)sender; |
|---|
| | | |
|---|
| | | @end |
|---|
| | | |
|---|
| | | #pragma mark - Deprecated API |
|---|
| | | |
|---|
| | | @interface CYLPlusButton (CYLDeprecated) |
|---|
| | | |
|---|
| | | + (void)registerSubclass CYL_DEPRECATED("Deprecated in 1.6.0. Use `+[CYLPlusButton registerPlusButton]` instead."); |
|---|
| | | |
|---|
| | | @end |
|---|
