//
|
// 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
|
