iOS 轮播图 YJBannerView 的使用方法详解

源码: YJBannerView Github源码地址

YJBannerView

• 使用简单、功能丰富的 Objective-C版 轮播控件, 基于 UICollectionView 实现, 多种场景均支持使用.

效果样例

Features

• [x] 支持自带PageControl样式配置, 也支持自定义
• [x] 支持上、下、左、右四个方向自动、手动动滚动
• [x] 支持自动滚动时间设置
• [x] 支持首尾循环滚动的开关
• [x] 支持滚动相关手势的开关
• [x] 支持ContentMode的设置
• [x] 支持Banner标题的设置自定义
• [x] 支持自定义UICollectionViewCell
• [x] 支持自定义 UIView 填充BannerView
• [x] 支持在Storyboard\xib中创建并配置其属性
• [x] 支持非首尾循环的Footer样式和进入详情回调
• [x] 不依赖其他三方SDWebImage或者AFNetworking设置图片
• [x] 支持CocoaPods
• [x] 支持Carthage

Installation

Cocoapods

YJBannerView is available through CocoaPods. To install it, simply add the following line to your Podfile:

    pod 'YJBannerView'

Carthage

    github "stackhou/YJBannerViewOC"

Usage

1.创建BannerView:

-(YJBannerView *)normalBannerView{
    if (!_normalBannerView) {
        _normalBannerView = [YJBannerView bannerViewWithFrame:CGRectMake(0, 20, kSCREEN_WIDTH, 180) dataSource:self delegate:self placeholderImageName:@"placeholder" selectorString:@"sd_setImageWithURL:placeholderImage:"];
        _normalBannerView.pageControlAliment = PageControlAlimentRight;
        _normalBannerView.autoDuration = 2.5f;
    }
    return _normalBannerView;
}

2.实现数据源方法和代理:

// 将网络图片或者本地图片 或者混合数组
- (NSArray *)bannerViewImages:(YJBannerView *)bannerView{
    return self.imageDataSources;
}

// 将标题对应数组传递给bannerView 如果不需要, 可以不实现该方法
- (NSArray *)bannerViewTitles:(YJBannerView *)bannerView{
    return self.titlesDataSources;
}

// 代理方法 点击了哪个bannerView 的 第几个元素
-(void)bannerView:(YJBannerView *)bannerView didSelectItemAtIndex:(NSInteger)index{
    NSString *title = [self.titlesDataSources objectAtIndex:index];
    NSLog(@"当前%@-->%@", bannerView, title);
}

扩展自定义方法

// 自定义Cell方法
- (Class)bannerViewCustomCellClass:(YJBannerView *)bannerView{
    return [HeadLinesCell class];
}

// 自定义Cell的数据刷新方法
- (void)bannerView:(YJBannerView *)bannerView customCell:(UICollectionViewCell *)customCell index:(NSInteger)index{

    HeadLinesCell *cell = (HeadLinesCell *)customCell;
    [cell cellWithHeadHotLineCellData:@"打折活动开始了~~快来抢购啊"];
}

版本记录

• 2015/5/10 版本1.0 生成静态库.a的方式，使用 Cocoapods 导入
• 2016/10/17 版本2.0 源码的方式使用 Cocoapods 导入
• 2017/5/29 版本2.1 默认自动滚动时间间隔调整为3s、动画变化比例调整为1.0、设置标题默认 边间距为10, 可任意设置, 支持Carthage
• 2017/7/3 版本2.1.1 通过传递UIImageView设置网络图片的方法给BannerView设置图片, 不再 依赖其他三方库，如: SDWebImage
• 2017/7/14 版本2.1.4 代码功能及结构优化
• 2017/7/21 版本2.1.5 代码功能优化
• 2017/7/25 版本2.1.6 1.新增cycleScrollEnable控制是否需要首尾相连; 2.新增 bannerGestureEnable 手势是否可用 3.新增bannerView:didScrollCurrentIndex:代理方法, 可以自定义PageControl
• 2017/7/28 版本2.1.7 1.新增FooterView 2.新增自定义View bannerView:viewForItemAtIndex: 方法
• 2017/7/30 版本2.2.0 调优、降低内存消耗
• 2017/8/21 版本2.2.1 当数据源不为零时, 隐藏背景图片
• 2017/9/25 版本2.2.2 当网络加载时间很长时 PlaceHolder 显示优化

源码: YJBannerView Github源码地址