请更新 CYLTabBarController 1.99.66 查看演示： Update to CYLTabBarController 1.99.66 to see the demo:

1.99.39 版本现已支持在 iOS 26 运行期间增加或删除加号按钮。效果见下方演示，欢迎访问 Demo 进行尝试： Version 1.99.39 supports adding or removing the plus button at runtime on iOS 26. See the demo below or visit the Demo to try it:

[CN]谁在使用？已上架 App 列表

[EN]Who is using it? Published apps

[CN]导航

[EN]CONTENTS

• 与其他自定义TabBarController的区别
• 集成后的效果：
• 项目结构
• 使用CYLTabBarController
  • 第一步：使用CocoaPods导入CYLTabBarController
  • 第二步：设置CYLTabBarController的两个数组：控制器数组和TabBar属性数组
  • 第三步：将CYLTabBarController设置为window的RootViewController
  • 第四步（可选）：创建自定义的形状不规则加号按钮
• 补充说明
  • 自定义 TabBar 样式
    • 捕获 TabBar 点击事件
  • 点击 TabBarButton 时添加动画
  • 横竖屏适配
  • 访问初始化好的 CYLTabBarController 对象
  • 点击 PlusButton 跳转到指定 UIViewController
  • 让TabBarItem仅显示图标，并使图标垂直居中
  • 多TabBar嵌套，并指定PlusButton位置
  • 在 Swift 项目中使用 CYLTabBarController
  • 搭配 Storyboard 使用 CYLTabBarController
  • 源码实现原理
• FAQ

[CN]与其他自定义 TabBarController 的区别

[EN]Comparison with other libraries

学习交流群：515295083 Learning group: 515295083.

[CN]集成后的效果

[EN]Results after integration

Supports portrait and landscape orientations.

[CN]项目结构

[EN]Project structure

说明： The directory structure is organized as follows:

├── CYLTabBarController  # 核心库文件夹；不使用 CocoaPods 时可直接拖入项目
└── Example
   └── Classes
       ├── Module       # 模块类文件夹 / Module classes
       │   ├── Home
       │   ├── Message
       │   ├── Mine
       │   └── SameCity
       └── View         # CYLPlusButton 子类；演示自定义不规则 PlusButton

[CN]使用 CYLTabBarController

[EN]Using CYLTabBarController

[CN]第一步：使用 CocoaPods 导入 CYLTabBarController

[EN]Step 1: Import CYLTabBarController with CocoaPods

[CN]1. 安装 CocoaPods

[EN]1. Install CocoaPods

    sudo gem install cocoapods  

    gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/     sudo gem install cocoapods  

[CN]2. 查询 CocoaPods 源

[EN]2. Search the CocoaPods repository

    pod search CYLTabBarController  

    pod repo update  

[CN]3. 使用 CocoaPods 导入

[EN]3. Integrate with CocoaPods

    pod init  

gem install cocoapods

pod 'CYLTabBarController', '~> 1.24.0'

pod install

# 禁止升级 CocoaPods 的 spec 仓库，否则会卡在 Analyzing dependencies，非常慢
pod update --verbose --no-repo-update

[CN]CocoaPods 使用说明

[EN]CocoaPods usage notes

[CN]指定 CYLTabBarController 版本

[EN]Pinning the CYLTabBarController version

pod 'CYLTabBarController', '~> 1.24.0'

[CN]升级本地 CocoaPods 源

[EN]Update the local CocoaPods repository

pod repo update

[CN]升级工程中的 CYLTabBarController 版本

[EN]Upgrade CYLTabBarController in the project

pod update

[CN]清除 CocoaPods 本地缓存

[EN]Clear the CocoaPods cache

[CN]查看当前使用的版本

[EN]Check the installed version

[CN]使用 Carthage 导入 CYLTabBarController（可选）

[EN]Import CYLTabBarController with Carthage (optional)

github "ChenYilong/CYLTabBarController"

carthage update --use-xcframeworks

[CN]第二步：设置 CYLTabBarController 的两个数组

[EN]Step 2: Configure the view controller and tab bar item attribute arrays

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

[CN]第三步：将 CYLTabBarController 设置为 window 的 RootViewController

[EN]Step 3: Set CYLTabBarController as the window's root view controller

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
/* *省略部分：   * */
   [self.window setRootViewController:self.tabBarController];
/* *省略部分：   * */
   return YES;
}

[CN]第四步（可选）：创建自定义的不规则加号按钮

[EN]Step 4 (optional): Create a custom irregular plus button

+ (void)load {
   [super registerPlusButton];
}

+ (NSUInteger)indexOfPlusButtonInTabBar;
+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;
+ (UIViewController *)plusChildViewController;
+ (BOOL)shouldSelectPlusChildViewController;

+ (NSUInteger)indexOfPlusButtonInTabBar;

+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;

+ (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight;

+ (UIViewController *)plusChildViewController;

   //去除 TabBar 自带的顶部阴影
   [[UITabBar appearance] setShadowImage:[[UIImage alloc] init]];

// iOS 10 and later: use -[CYLTabBarController hideTabBarShadowImageView]. // See the AppDelegate example.

[CN]调整 PlusButton 与 TabBarItem 的宽度

[EN]Customize the PlusButton and TabBarItem widths

TabBarItem 宽度 ＝  ( TabBar 总宽度 －  PlusButton 宽度  ) / (TabBarItem 个数)

[button sizeToFit];

button.frame = CGRectMake(0.0, 0.0, 250, 100);
button.backgroundColor = [UIColor redColor];

[CN]补充说明

[EN]Additional notes

[CN]自定义 TabBar 样式

[EN]Customizing the TabBar appearance

/**
*  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;
}

[CN]捕获 TabBar 点击事件

[EN]Handling TabBar selection events

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

//UITabBarController.h
@protocol UITabBarControllerDelegate <NSObject>
@optional
- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController NS_AVAILABLE_IOS(3_0);
@end

- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
   [[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
   return YES;
}

@interface AppDelegate ()<UITabBarControllerDelegate, CYLTabBarControllerDelegate>

@end

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
   //...
       tabBarControllerConfig.tabBarController.delegate = self;
   //...
   return YES;
}

[CN]点击 TabBarButton 时添加动画

[EN]Adding animations when a TabBar button is tapped

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

@interface AppDelegate ()<UITabBarControllerDelegate, CYLTabBarControllerDelegate>

@end

//AppDelegate.m
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control {
   UIView *animationView;
   // If PlusButton has its own action, this delegate is not called for it.
   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];
   }
}

// 缩放动画 / Scale animation
- (void)addScaleAnimationOnView:(UIView *)animationView {
   // Customize the keyframe animation as needed.
   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];
}

// 旋转动画 / Rotation animation
- (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];
   });
}

[CN]横竖屏适配

[EN]Supporting portrait and landscape orientations

- (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]];
}

[CN]访问初始化好的 CYLTabBarController 对象

[EN]Accessing the initialized CYLTabBarController instance

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

//导入 CYLTabBarController.h
#import "CYLTabBarController.h"

- (void)viewDidLoad {
   [super viewDidLoad];
   CYLTabBarController *tabbarController = [self cyl_tabBarController];
   /*...*/
}

[CN]点击 PlusButton 跳转到指定 UIViewController

[EN]Navigating to a UIViewController by tapping the PlusButton

#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;
   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]);
//}

+ (BOOL)shouldSelectPlusChildViewController;

+ (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;
}

[CN]让 TabBarItem 仅显示图标并使图标垂直居中

[EN]Display only icons in TabBarItems and center them vertically

[CN]多 TabBar 嵌套并指定 PlusButton 位置

[EN]Nesting multiple TabBars and specifying the PlusButton position

//CYLPlusButtonSubclassing
+ (NSString *)tabBarContext;

[CN]在 Swift 项目中使用 CYLTabBarController

[EN]Using CYLTabBarController in a Swift project

platform :ios, '8.0'
# Uncomment the next line when you want all Pods as static framework
# use_modular_headers!
pod 'CYLTabBarController', '~> 1.29.0', :modular_headers => true

platform :ios, '8.0'
use_frameworks!

[CN]搭配 Storyboard 使用 CYLTabBarController

[EN]Using CYLTabBarController with Storyboard

[CN]源码实现原理

[EN]Implementation details

[CN]常见问题

[EN]FAQ

[CN]为什么放置 6 个 TabBarItem 会显示异常？

[EN]Why does placing six TabBarItems behave unexpectedly?

[CN]按钮响应区域发生偏移

[EN]The button hit area is offset

[CN]如何添加选中背景色？

[EN]How can I add a selected background color?

/**
*  更多TabBar自定义设置：比如：tabBarItem 的选中和不选中文字和背景图片属性、tabbar 背景图片属性
*/
- (void)customizeTabBarAppearance:(CYLTabBarController *)tabBarController;

[CN]ViewController 标题与 TabBar 标题不一致

[EN]The ViewController title does not match the TabBar title

   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

[CN]调用 cyl_popSelectTabBarChildViewControllerAtIndex: 时出现黑边

[EN]Black borders appear when calling cyl_popSelectTabBarChildViewControllerAtIndex:

//#import "CYLTabBarController.h"
   [[self cyl_tabBarController] rootWindow].backgroundColor = [UIColor whiteColor];

[CN]凸起的图标超出 49pt 后无法响应

[EN]A raised icon does not respond above 49pt

[CN]为什么 iOS 10 会崩溃而 iOS 9 不会？

[EN]Why does it crash on iOS 10 but not iOS 9?

+ (void)load {
   [super registerPlusButton];
}

[CN]PlusButton 选中后无法恢复为 normal

[EN]PlusButton remains selected after selecting another tab

- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
   [[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
   return YES;
}

[CN]PlusButton 与其他 TabBarItem 的间距不均匀

[EN]The PlusButton is not evenly spaced

[button sizeToFit];

button.frame = CGRectMake(0.0, 0.0, w, h);

[UIScreen mainScreen].bounds.size.width / [CYLTabBarController allItemsInTabBarCount]

[CN]如何兼容 Lottie 动画？

[EN]How do I integrate Lottie animations?

[CN]Star 历史

[EN]Star history