BAGridView
BAHome Team Name
1、功能及简介
- 1、支付宝首页 九宫格 布局封装
- 2、自适应按钮位置和数量
- 3、自定义文字图片 或者 两行文字样式
- 4、自定义分割线：显示/隐藏
- 5、自定义分割线：颜色
- 6、新增 支持 自定义 图片文字间距功能（感谢群里 @武汉-马阿飞 同学提出的 需求！）
- 7、新增 自定义 所有文字字体（感谢群里 @武汉-马阿飞 同学提出的 需求！）
- 8、新增 支持 自定义 item 背景颜色 和 选中背景颜色（感谢群里 @武汉-马阿飞 同学提出的 需求！）
2、图片示例
BAGridView1
BAGridView2
3、安装、导入示例和源码地址
- 1、pod 导入【最新版本：
】：
pod 'BAGridView'
如果发现pod search BAGridView搜索出来的不是最新版本，需要在终端执行 cd 转换文件路径命令退回到 desktop，然后执行pod setup命令更新本地spec缓存（可能需要几分钟），然后再搜索就可以了。
具体步骤：- pod setup : 初始化
- pod repo update : 更新仓库
- pod search BAGridView
- 2、文件夹拖入：下载demo，把 BAGridView 文件夹拖入项目即可，
- 3、导入头文件：
#import "BAKit_BAGridView.h"
- 4、项目源码地址：
OC 版 ：https://github.com/BAHome/BAGridView
4、BAGridView 的类结构及 demo 示例
BAGridView
BAKit_BAGridView.h
#ifndef BAKit_BAGridView_h
#define BAKit_BAGridView_h
#import "BAGridView.h"
#import "BAGridItemModel.h"
#import "BAKit_ConfigurationDefine.h"
/*!
*********************************************************************************
************************************ 更新说明 ************************************
*********************************************************************************
欢迎使用 BAHome 系列开源代码 ！
如有更多需求，请前往：https://github.com/BAHome
项目源码地址：
OC 版 ：https://github.com/BAHome/BAGridView
最新更新时间：2017-06-21 【倒叙】<br>
最新Version：【Version：1.0.2】<br>
更新内容：<br>
1.0.2.1、新增 支持 自定义 item 背景颜色 和 选中背景颜色（感谢群里 [@武汉-马阿飞](http://www.jianshu.com/u/7f8b1720f857) 同学提出的 需求！）<br>
最新更新时间：2017-06-21 【倒叙】<br>
最新Version：【Version：1.0.1】<br>
更新内容：<br>
1.0.1.1、新增 支持 自定义 图片文字间距功能（感谢群里 [@武汉-马阿飞](http://www.jianshu.com/u/7f8b1720f857) 同学提出的 需求！）<br>
1.0.1.2、新增 自定义 所有文字字体（感谢群里 [@武汉-马阿飞](http://www.jianshu.com/u/7f8b1720f857) 同学提出的 需求！）<br>
最新更新时间：2017-06-20 【倒叙】<br>
最新Version：【Version：1.0.0】<br>
更新内容：<br>
1.0.0.1、支付宝首页 九宫格 布局封装<br>
1.0.0.2、自适应按钮位置和数量<br>
1.0.0.3、自定义文字图片 或者 两行文字样式<br>
1.0.0.4、自定义分割线：显示/隐藏<br>
1.0.0.5、自定义分割线：颜色<br>
*/
#endif /* BAKit_BAGridView_h */
BAGridView.h
#import <UIKit/UIKit.h>
@class BAGridItemModel, BAGridView;
/**
宫格样式
- BAGridViewTypeImageTitle: 上面是图片，下面是文字
- BAGridViewTypeTitleDesc: 上下都是文字，上面标题字体大，下面是详情字体小
*/
typedef NS_ENUM(NSUInteger, BAGridViewType) {
BAGridViewTypeImageTitle = 0,
BAGridViewTypeTitleDesc
};
/**
BAGridView 回调
@param model 返回 BAGridItemModel
@param indexPath indexPath
*/
typedef void (^BAGridViewBlock)(BAGridItemModel *model, NSIndexPath *indexPath);
/**
BAGridView 配置回调
@param tempView BAGridView
*/
typedef void (^BAGridView_configurationBlock)(BAGridView *tempView);
@interface BAGridView : UIView
/**
宫格样式，默认：BAGridViewTypeImageTitle
*/
@property(nonatomic, assign) BAGridViewType gridViewType;
/**
数据源：来自 BAGridItemModel
*/
@property(nonatomic, strong) NSArray <BAGridItemModel *>*dataArray;
/**
item：点击回调
*/
@property(nonatomic, copy) BAGridViewBlock ba_gridViewBlock;
/**
item：高度，图片高度 默认：ba_gridView_itemHeight * 0.4
*/
@property(nonatomic, assign) CGFloat ba_gridView_itemHeight;
/**
item：图片与文字间距（或者两行文字类型的间距），默认：0
*/
@property(nonatomic, assign) CGFloat ba_gridView_itemImageInset;
/**
item：每行 item 的个数，默认：4个
*/
@property(nonatomic, assign) NSInteger ba_gridView_rowCount;
/**
item：title 颜色，默认：BAKit_Color_Black【[UIColor blackColor]】
*/
@property(nonatomic, strong) UIColor *ba_gridView_titleColor;
/**
item：Desc 颜色，默认：BAKit_Color_Gray_9【BAKit_Color_RGB(216, 220, 228)】
*/
@property(nonatomic, strong) UIColor *ba_gridView_titleDescColor;
/**
item：分割线颜色，默认：BAKit_Color_Gray_10【BAKit_Color_RGB(240, 240, 240)】
*/
@property(nonatomic, strong) UIColor *ba_gridView_lineColor;
/**
item：背景颜色，默认：BAKit_Color_White
*/
@property(nonatomic, strong) UIColor *ba_gridView_backgroundColor;
/**
item：背景选中颜色，默认：无色
*/
@property(nonatomic, strong) UIColor *ba_gridView_selectedBackgroundColor;
/**
item：是否显示分割线
*/
@property(nonatomic, assign, getter=isShowLineView) BOOL showLineView;
/**
item：title Font，默认：图文样式下 16，两行文字下（上25，下12）
*/
@property(nonatomic, strong) UIFont *ba_gridView_titleFont;
/**
item：Desc Font，默认：两行文字下 12
*/
@property(nonatomic, strong) UIFont *ba_gridView_titleDescFont;
/**
快速创建宫格
@param gridViewType 样式
@param dataArray 数据
@param configurationBlock 配置回调
@param block 点击事件回调
@return BAGridView
*/
+ (instancetype)ba_creatGridViewWithGridViewType:(BAGridViewType)gridViewType
dataArray:(NSArray <BAGridItemModel *>*)dataArray
configurationBlock:(BAGridView_configurationBlock)configurationBlock
block:(BAGridViewBlock)block;
@end
demo 示例
// 示例1：
- (BAGridView *)gridView
{
if (!_gridView)
{
_gridView = [BAGridView ba_creatGridViewWithGridViewType:BAGridViewTypeImageTitle dataArray:self.gridDataArray configurationBlock:^(BAGridView *tempView) {
// 是否显示分割线
// tempView.showLineView = NO;
// item：分割线颜色，默认：BAKit_Color_Gray_11【BAKit_Color_RGB(248, 248, 248)】
// tempView.ba_gridView_lineColor = BAKit_Color_Red;
// item：每行 item 的个数，默认为4个
tempView.ba_gridView_rowCount = kGridView_rowCount;
// item：高度
tempView.ba_gridView_itemHeight = kGridView_itemHeight;
// item：图片与文字间距（或者两行文字类型的间距），默认：0
// tempView.ba_gridView_itemImageInset = 10;
// item：title 颜色，默认：BAKit_Color_Black【[UIColor blackColor]】
// tempView.ba_gridView_titleColor = BAKit_Color_Black;
// item：title Font，默认：图文样式下 16，两行文字下（上25，下12）
tempView.ba_gridView_titleFont = [UIFont boldSystemFontOfSize:15];
// item：背景颜色，默认：BAKit_Color_White
tempView.ba_gridView_backgroundColor = BAKit_Color_White;
// item：背景选中颜色，默认：无色
tempView.ba_gridView_selectedBackgroundColor = BAKit_Color_Red;
self.gridView = tempView;
} block:^(BAGridItemModel *model, NSIndexPath *indexPath) {
BAKit_ShowAlertWithMsg_ios8(model.titleString);
}];
_gridView.backgroundColor = BAKit_Color_White;
}
return _gridView;
}
- (NSMutableArray <BAGridItemModel *> *)gridDataArray
{
if (!_gridDataArray)
{
_gridDataArray = @[].mutableCopy;
NSArray *imageNameArray = @[@"tabbar_mainframeHL", @"tabbar_mainframeHL", @"tabbar_mainframeHL", @"tabbar_mainframeHL", @"tabbar_mainframeHL"];
NSArray *titleArray = @[@"扫一扫", @"付钱", @"卡包", @"收银", @"卡包"];
for (NSInteger i = 0; i < titleArray.count; i++)
{
BAGridItemModel *model = [BAGridItemModel new];
model.imageName = imageNameArray[i];
model.titleString = titleArray[i];
[self.gridDataArray addObject:model];
}
}
return _gridDataArray;
}
// 示例2：
- (BAGridView *)gridView2
{
if (!_gridView2)
{
_gridView2 = [BAGridView ba_creatGridViewWithGridViewType:BAGridViewTypeTitleDesc dataArray:self.gridDataArray2 configurationBlock:^(BAGridView *tempView) {
// item：分割线颜色，默认：BAKit_Color_Gray_11【BAKit_Color_RGB(248, 248, 248)】
tempView.ba_gridView_lineColor = BAKit_Color_Red;
// item：每行 item 的个数，默认为4个
tempView.ba_gridView_rowCount = kGridView_rowCount2;
// item：高度
tempView.ba_gridView_itemHeight = kGridView_itemHeight2;
// item：图片与文字间距（或者两行文字类型的间距），默认：0
// tempView.ba_gridView_itemImageInset = 10;
// item：title 颜色，默认：BAKit_Color_Black【[UIColor blackColor]】
tempView.ba_gridView_titleColor = BAKit_Color_Black;
// item：Desc 颜色，默认：BAKit_Color_Gray_9【BAKit_Color_RGB(216, 220, 228)】
tempView.ba_gridView_titleDescColor = BAKit_Color_Gray_7;
// item：title Font，默认：图文样式下 16，两行文字下（上25，下12）
tempView.ba_gridView_titleFont = [UIFont boldSystemFontOfSize:25];
// item：Desc Font，默认：两行文字下 12
tempView.ba_gridView_titleDescFont = [UIFont boldSystemFontOfSize:15];
self.gridView2 = tempView;
} block:^(BAGridItemModel *model, NSIndexPath *indexPath) {
BAKit_ShowAlertWithMsg_ios8(model.titleString);
}];
_gridView2.backgroundColor = [UIColor yellowColor];
}
return _gridView2;
}
- (NSMutableArray <BAGridItemModel *> *)gridDataArray2
{
if (!_gridDataArray2)
{
_gridDataArray2 = @[].mutableCopy;
NSArray *titleArray = @[@"200", @"20", @"200", @"10", ];
NSArray *descArray = @[@"新增积分总量", @"返还积分总量", @"全返单元总量", @"每单元返还积分"];
for (NSInteger i = 0; i < titleArray.count; i++)
{
BAGridItemModel *model = [BAGridItemModel new];
model.desc = descArray[i];
model.titleString = titleArray[i];
[_gridDataArray2 addObject:model];
}
}
return _gridDataArray2;
}
其他示例可下载demo查看源码！
5、更新记录：【倒叙】
欢迎使用 【BAHome】 系列开源代码 ！
如有更多需求，请前往：【https://github.com/BAHome】
最新更新时间：2017-06-21 【倒叙】
最新Version：【Version：1.0.1】
更新内容：
1.0.1.1、新增 支持 自定义 图片文字间距功能（感谢群里 @武汉-马阿飞 同学提出的 需求！）
1.0.1.2、新增 自定义 所有文字字体（感谢群里 @武汉-马阿飞 同学提出的 需求！）
最新更新时间：2017-06-20 【倒叙】
最新Version：【Version：1.0.0】
更新内容：
1.0.0.1、支付宝首页 九宫格 布局封装
1.0.0.2、自适应按钮位置和数量
1.0.0.3、自定义文字图片 或者 两行文字样式
1.0.0.4、自定义分割线：显示/隐藏
1.0.0.5、自定义分割线：颜色
6、bug 反馈 和 联系方式
1、开发中遇到 bug，希望小伙伴儿们能够及时反馈与我们 BAHome 团队，我们必定会认真对待每一个问题！
2、以后提需求和 bug 的同学，记得把 git 或者博客链接给我们，我直接超链到你们那里！希望大家积极参与测试！
3、联系方式
QQ群：479663605 【注意：此群为 2 元 付费群，介意的小伙伴儿勿扰！】
博爱QQ：137361770
博爱微博：
7、开发环境 和 支持版本
开发使用 Xcode Version 8.3.2 (8E2002) ，理论上支持所有 iOS 版本，如有版本适配问题，请及时反馈！多谢合作！
8、感谢
感谢 BAHome 团队成员倾力合作，后期会推出一系列 常用 UI 控件的封装，大家有需求得也可以在 issue 提出，如果合理，我们会尽快推出新版本！
BAHome 的发展离不开小伙伴儿的信任与推广，再次感谢各位小伙伴儿的支持！
网友评论