PagingButton 0.2.0

PagingButton 0.2.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Aug 2017

Maintained by Mingoy.




一、介绍:

这是一个左右分页按钮的集合视图控件。用于快速编写出集合视图上分页多按钮点击事件!

原文在我博客: https://www.yfmingo.cn/2017/07/23/PagingButton/
效果图:

二、 使用:

支持 cocoapods,在你的 Podfile 文件中 加入 pod 'PagingButton' 然后终端cd到项目文件夹执行 pod install 即可:

pod 'PagingButton'

然后导入头文件,添加代理:

#import <PagingButtonView.h>

@interface ViewController ()<PagingButtonViewDelegate>

实现代理方法: 可在代理方法里执行各个按钮点击后的跳转页面操作

#pragma mark - PagingButtonViewDelegate
- (void)PagingButtonView:(PagingButtonView *)actionView clickButtonWithIndex:(NSInteger)index {
    
    NSLog(@"clickButtonWithIndex:%ld",(long)index);
}

简单使用:

self.demo02 = [[PagingButtonView alloc] init];
//    【若设置过大View的高度太小时程序会根据主View的高度推算出一个最大值的图标宽高】
//    _demo02.pageButtonIconSize = CGSizeMake(20, 20);
//    _demo02.pageButtonTitleFontSize = 14 ; //字体大小
    [_demo02 yfm_createPagingButtonViewWithFrame:CGRectMake(0, 350, [UIScreen mainScreen].bounds.size.width, 0) showToSuperView:self.view delegate:self iconUrlsOrNamesArr:@[@"yfzwxx",@"yfzsbs",@"yfqtms",@"yfxwzx",@"yfmsfq",@"yfczms"] buttonTextColorArrOrOneColor:[UIColor blueColor] buttonTitleArray:@[@"政务信息",@"掌上办事",@"倾听民声",@"新闻资讯",@"民俗风情",@"吃在天朝"]];

NSLog(@"当_demo02的View高度太小而设置的pageButtonIconSize过大时,程序会自动推算出当前高度下最大的pageButtonIconSize。可在此范围内重新设置pageButtonIconSize大小。  \n:width:%.2f,height:%.2f",_demo02.pageButtonIconSize.width,_demo02.pageButtonIconSize.height);

自定义使用:

 self.demo01 = [[PagingButtonView alloc] init];
    
//         pageControl 当前页颜色 【默认不写为 darkGrayColor】
        _demo01.pageControlCurrentPageColor = [UIColor redColor];

//         pageControl 其他页颜色 【默认不写为 lightGrayColor】
        _demo01.pageControlOtherPageColor = [UIColor blueColor];

//          PageControl 样式 【默认不写为 小灰点】
        _demo01.pageControlStyle = PageControlStyleLongImage;

        _demo01.pagingRow = 3; //设置行,不设置默认2行
        _demo01.pagingColumn = 5; //设置列 【不设置 默认4列 最大8列,超过8列的都是流氓】
    
//        按钮点击动画效果 【默认带有点击效果】
//        _demo01.hasClickAnimation = NO;

//      按钮图标若为URL时的占位图。默认不传就用本项目自带占位图
//      _demo01.pagingButtonPlaceholderName = @"占位图名称";

    UILabel *title = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, 0, 30)];
    title.textColor = [UIColor redColor];
    title.backgroundColor = [UIColor lightGrayColor];
    title.textAlignment = NSTextAlignmentCenter;
    title.text = @"图标可以URL或者图片文件名称啊";
    
//        设置大标题 【默认不设置 没有标题】
    _demo01.mainTitleLab = title;
    
//        按钮的图标大小(建议宽高相等)。【若设置过大View的高度太小时程序会根据主View的高度推算出一个最大值的图标宽高】
    _demo01.pageButtonIconSize = CGSizeMake(20, 20);
    _demo01.pageButtonTitleFontSize = 10 ; //字体大小

//        配置完自定义属性后最后一步调用此方法。
    CGRect demo01frame =  [_demo01 yfm_createPagingButtonViewWithFrame:CGRectMake(20,50, 300, 200)  showToSuperView:self.view  delegate:self iconUrlsOrNamesArr:@[@"yf-homeswcx",@"yf-homeswcx",@"yf-homeswcx",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"http://www.yooyoo360.com/photo/2009-1-1/20090113082955297.jpg",@"yf-homeswcx",@"yf-homeswcx",@"yf-homeswcx"] buttonTextColorArrOrOneColor:@[[UIColor colorWithRed:0.984 green:0.467 blue:0.082 alpha:1.000],[UIColor colorWithRed:0.169 green:0.557 blue:0.929 alpha:1.000],[UIColor colorWithRed:0.973 green:0.220 blue:0.247 alpha:1.000],[UIColor colorWithRed:0.525 green:0.780 blue:0.137 alpha:1.000],[UIColor colorWithRed:0.988 green:0.761 blue:0.145 alpha:1.000],[UIColor colorWithRed:0.757 green:0.341 blue:0.925 alpha:1.000],[UIColor colorWithRed:0.149 green:0.773 blue:0.682 alpha:1.000],[UIColor colorWithRed:0.929 green:0.267 blue:0.408 alpha:1.000],[UIColor colorWithRed:0.992 green:0.459 blue:0.078 alpha:1.000]] buttonTitleArray:@[@"政务信息",@"掌上办事",@"倾听民声",@"新闻资讯",@"民俗风情",@"吃在天朝",@"玩在天朝",@"住在天朝",@"行在天朝",@"精彩图集",@"免费WIFI",@"天气查询",@"空气查询",@"快递查询",@"税务查询",@"违章查询",@"水费查询"]];
    
    NSLog(@"demo01frame:(x:%2f,y:%2f,W:%2f,H:%2f)",demo01frame.origin.x,demo01frame.origin.y,demo01frame.size.width,demo01frame.size.height);

三、更新:

  • 2017.08.02(r0.2.0版本):
    • 新增设置主图标大小的属性接口(pageButtonIconSize
    • 更改主View是frame计算方式为外部直接传入。当主View高度太小而设置的pageButtonIconSize过大时,程序会自动推算出当前高度下最大的pageButtonIconSize。可在此范围内重新设置pageButtonIconSize大小。

四、联系:

五、后记:

  • 欢迎大家使用哈。如果大家发现问题和有好的建议欢迎随时 IssuesPull requests
  • 如果用的好欢迎点个星星以鼓励。你的 Star 是我源源不断努力优化的最大动力。