An open API service indexing awesome lists of open source software.

https://github.com/coderzhuxh/xhtabbar

一行代码创建自定义tabBar - 支持小红点、数字角标、自定义高度
https://github.com/coderzhuxh/xhtabbar

Last synced: about 1 year ago
JSON representation

一行代码创建自定义tabBar - 支持小红点、数字角标、自定义高度

Awesome Lists containing this project

README

          

# XHTabBar
#### 快速创建自定义TabBar,支持小红点,数字角标及自定义高度

[![AppVeyor](https://img.shields.io/appveyor/ci/gruntjs/grunt.svg?maxAge=2592000)](https://github.com/CoderZhuXH/XHTabBar)
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/CoderZhuXH/XHTabBar)
[![Version Status](https://img.shields.io/cocoapods/v/XHTabBar.svg?style=flat)](http://cocoadocs.org/docsets/XHTabBar)
[![Support](https://img.shields.io/badge/support-iOS%207%2B-brightgreen.svg)](https://github.com/CoderZhuXH/XHTabBar)
[![Pod Platform](https://img.shields.io/cocoapods/p/XHTabBar.svg?style=flat)](http://cocoadocs.org/docsets/XHTabBar)
[![Pod License](https://img.shields.io/cocoapods/l/XHTabBar.svg?style=flat)](https://github.com/CoderZhuXH/XHTabBar/blob/master/LICENSE)

==============

#### Swift版请戳这里>>> https://github.com/CoderZhuXH/XHTabBarSwift
###技术交流群(群号:537476189).
## 效果
![image](https://raw.githubusercontent.com/CoderZhuXH/XHTabBar/master/DEMO.PNG)

## 使用方法
### 1.在Appdelegate 中初始化,并设置为根控制器
```objc
//控制器数组
NSArray *controllerArray = @[@"MainVC",@"MsgVC",@"FriendVC",@"MeVC"];
//title数组
NSArray * titleArray = @[@"首页",@"消息",@"朋友",@"我的"];
//默认图片数组
NSArray *imageArray= @[@"home_tabbar",@"msg_tabbar",@"friend_tabbar",@"me_tabbar"];
//选中图片数组
NSArray *selImageArray = @[@"home_tabbar_sel",@"msg_tabbar_sel",@"friend_tabbar_sel",@"me_tabbar_sel"];
//tabBar高度
CGFloat tabBarHeight = 49.0;

//初始化(height:最小高度为49.0,当传nil 或<49.0时均按49.0处理)
XHTabBar *tabbar = [[XHTabBar alloc] initWithControllerArray:controllerArray titleArray:titleArray imageArray:imageArray selImageArray:selImageArray height:tabBarHeight];

//设置为根控制器
self.window.rootViewController = tabbar;
```
### 2.点击代理
```objc

/**
tabBar 点击事件回调

@param tabBar tabBar
@param viewController 选中的viewController
*/
-(void)xhTabBar:(XHTabBar *)tabBar didSelectViewController:(UIViewController *)viewController;

```

### 3.影藏tabBar
```objc
//push界面时,若需影藏tabBar,调用系统方法设置影藏即可,如下
MsgVC *VC = [[MsgVC alloc] init];
VC.hidesBottomBarWhenPushed = YES;
[self.navigationController pushViewController:VC animated:YES];
```
### 4.角标、小红点及其他设置接口
```objc
/**
* 设置tabBar显示指定控制器
*
* @param index 位置
*/
-(void)showControllerIndex:(NSInteger)index;

/**
* 数字角标
*
* @param num 所要显示数字
* @param index 位置
*/
-(void)showBadgeMark:(NSInteger)badge index:(NSInteger)index;

/**
* 小红点
*
* @param index 位置
*/
-(void)showPointMarkIndex:(NSInteger)index;

/**
* 影藏指定位置角标
*
* @param index 位置
*/
-(void)hideMarkIndex:(NSInteger)index;
```
### 5.定义tabbar文字大小,颜色,请在XHTabBar.m 顶部修改下面宏定义
```objc
//RGB颜色
#define RGBCOLOR(r,g,b) [UIColor colorWithRed:(r)/255.0f green:(g)/255.0f blue:(b)/255.0f alpha:1]
//title默认颜色
#define TitleColor [UIColor grayColor]
//title选中颜色
#define TitleColor_Sel RGBCOLOR(41, 167, 245)
//title字体大小
#define TitleFontSize 12.0
//TabBar背景色
#define TabBarBackgroundColor [UIColor whiteColor]

//数字角标直径
#define NumMark_W_H 20
//小红点直径
#define PointMark_W_H 12
```
## 安装
### 手动添加:

* 1.将 XHTabBar 文件夹添加到工程目录中

* 2.导入 XHTabBar.h

### CocoaPods:

* 1.在 Podfile 中添加 pod 'XHTabBar'

* 2.执行 pod install 或 pod update

* 3.导入 XHTabBar.h

### Tips
* 1.如果发现pod search XHTabBar 搜索出来的不是最新版本,需要在终端执行cd desktop退回到desktop,然后执行pod setup命令更新本地spec缓存(需要几分钟),然后再搜索就可以了
* 2.如果你发现你执行pod install后,导入的不是最新版本,请删除Podfile.lock文件,在执行一次 pod install

## 系统要求
* 该项目最低支持 iOS 7.0 和 Xcode 7.0

## 许可证
XHTabBar 使用 MIT 许可证,详情见 LICENSE 文件