iOS轮播图封装 ECAutoScrollBanner

ECAutoScrollBanner

轮播图封装。可以兑现全自动定时翻页、手动翻页;垂直和程度滚动等。帮助纯文本、本地图片、网络图片以及此外view试图。

bug fix:

  1. 创建view试图类的轮播图优化修复。(注意:view视图类的轮播中,view的坐标是周旋于cell.contentView的坐标,是contentView的子视图)

Github:https://github.com/EchoZuo/ECAutoScrollBanner

Navigation 导航

Abstract 概要

简介&特性

轮播图封装,网上有诸多现成的demo,也没怎么难度。这多少个是很早此前写过的轮播图封装,本次正好需要就重新整理一下发出来,希望能辅助到需要的人。

  • 帮帮手动翻页、自动定时翻页
  • 支撑垂直和品位滚动
  • 支撑当地图片、网络图片、纯文本以及其他View视图,如图文混合排版的视图等。
  • 扶助设置彰显和隐藏pageControl和自定义pageControl的frame
  • 可以做简便修改,将索要的一定属性开放利用

效果图

image

Explain 说明

落实模式

轮播图基本实现思路有如下三种,本次封装使用的是第一种办法,用UICollectionView实现。
  1. 基于UICollectionView的包装(推荐应用)
    1. 实现便民,使用方便,并且实现代码也不复杂;
    2. 大气加载和滚动或者电动轮播的时候基本不需要考虑录用性能等问题
  2. 用UIScrollView+UIImageView的点子贯彻A
    1. 用户阅览的是五个UIImageView的兑现情势;
    2. 假若数量太多,需要考虑到选定等属性问题;
    3. 一旦底层是UITableView并且轮播图是当做cell的话,更需要考虑到tableView嵌套scrollView的轮转性能问题。
  3. 用UIScrollView+UIImageView的办法实现B
    1. 只需要创造3个UIImageView,不需要考虑录用问题;
    2. 与第三种不同的固然用户永远看到的是中间这一个UIImageView,只是上面的情节再持续变化,其内部贯彻其实是在持续的变更非凡轮播数组。
  4. 惟有一个UIImageView
    1. 这种实现模式不再基于ScrollView,同样不设有重用等的题材。这种实现情势跟第三种有相似之处,然则它跟第二种的区别是不再采用scrollView的图样切换情势。仍旧不停地去改变这一个数组的情节。这种实现情势的着力在于切换的时候使用自定义的layer层的转场动画。模拟scrollView的滑行效果。
此次封装实现思路
  • 底层采取UICollectionView当控制器。给原数据源下标0位添加原多少源末最后多少个据,给元数据源下标末尾添加原数据源0位的数量。以此形成一个新的数据源。能够参照下图
image
襄援手动翻页和定时翻页
  • 手动翻页没什么可说的。自动翻页其实就是一个简易的定时器(用NS提姆(Tim)er和GCD都ok)实现定时调用对应的翻页方法即可。
辅助竖向垂直翻页和水准翻页
typedef NS_ENUM(NSInteger, ECAutoScrollBannerScrollDirection){
    ECAutoScrollBannerScrollDirectionVertical       = 1,    // 竖向滚动
    ECAutoScrollBannerScrollDirectionHorizontal     = 0,    // 横向滚动
};

详尽介绍

盛开的一些安装属性(代码中注释都很详细,也得以直接翻看源码即可)
/**
 * delegate,非必
 */
@property (nonatomic, weak) id<ECAutoScrollBannerDelegate> delegate;

/**
 * 是否自动翻页,默认NO,非必
 */
@property (nonatomic, assign) BOOL isAutoPaging;

/**
 * 是否展示PageControl,默认YES,非必
 */
@property (nonatomic, assign) BOOL isHavePageControl;

/**
 * 是否无限循环,默认NO,非必
 */
@property (nonatomic, assign) BOOL isInfinitePaging;

/**
 * 自动翻页的时候知否支持手动滑动,必须在isAutoPaging=YES时候设置才有效果,if isAutoPaging=YES,则这个必须设置
 */
@property (nonatomic, assign) BOOL isEnabledPanGestureRecognizer;

/**
 * collectionView backgroundColor,默认lightGrayColor,非必
 */
@property (nonatomic, strong) UIColor *collectionViewBgColor;

/**
 * 可以自定义pageControl的frame(相对于self),必须isHavePageControl=YES,如果没有设置新坐标,则取默认坐标,非必
 */
@property (nonatomic, assign) CGRect pageControlFrame;

/**
 * 自动翻页间隔时间。需isAutoPaging=YES才需要设置,否则设置什么效果。默认3.0f
 */
@property (nonatomic, assign) CGFloat  autoPageInterval;
重中之重的有的总计
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
    if (self.isAutoPaging) {
        scrollView.panGestureRecognizer.enabled = self.isEnabledPanGestureRecognizer;
    }

    NSInteger page = 0;

    // 是否无限循环
    if (!self.isInfinitePaging) {
        if (self.bannerScrollDirection == ECAutoScrollBannerScrollDirectionHorizontal) {
            page = scrollView.contentOffset.x / scrollView.frame.size.width;
        } else {
            page = scrollView.contentOffset.y / scrollView.frame.size.height;
        }
        self.pageControl.currentPage = page;
    } else {
        if (self.bannerScrollDirection == ECAutoScrollBannerScrollDirectionHorizontal) {
            page = scrollView.contentOffset.x / scrollView.frame.size.width;

            // 第一张
            if ((page == 0) && (scrollView.contentOffset.x <= 30)) {
                page = self.mainDataSource.count - 2;

                NSIndexPath *indexPath = [NSIndexPath indexPathForItem:page inSection:0];
                [self.collectionView scrollToItemAtIndexPath:indexPath atScrollPosition:UICollectionViewScrollPositionNone animated:NO];
            } else if ((page == self.mainDataSource.count - 1) && (scrollView.contentOffset.x >= scrollView.contentSize.width - scrollView.frame.size.width - 30)) {
                // 最后一张
                page = 0 + 1;
                NSIndexPath *indexPath = [NSIndexPath indexPathForItem:page inSection:0];
                [self.collectionView scrollToItemAtIndexPath:indexPath atScrollPosition:UICollectionViewScrollPositionNone animated:NO];
            }
        } else {
            page = scrollView.contentOffset.y / scrollView.frame.size.height;

            // 第一张
            if ((page == 0) && (scrollView.contentOffset.y <= 30)) {
                page = self.mainDataSource.count - 2;

                NSIndexPath *indexPath = [NSIndexPath indexPathForItem:page inSection:0];
                [self.collectionView scrollToItemAtIndexPath:indexPath atScrollPosition:UICollectionViewScrollPositionNone animated:NO];
            } else if ((page == self.mainDataSource.count - 1) && (scrollView.contentOffset.y >= scrollView.contentSize.height - scrollView.frame.size.height - 30)) {
                // 最后一张
                page = 0 + 1;
                NSIndexPath *indexPath = [NSIndexPath indexPathForItem:page inSection:0];
                [self.collectionView scrollToItemAtIndexPath:indexPath atScrollPosition:UICollectionViewScrollPositionNone animated:NO];
            }
        }
        self.pageControl.currentPage = page - 1;
    }
}

Usage 使用

选取办法

  1. 将ECAutoScrollBanner文件夹直接拖入项目中,导入头文件#2018正版葡京赌侠诗,import
    “ECAutoScrollBanner.h”
  2. CocoaPods:pod ‘ECAutoScrollBanner’

动用示例

其实使用起来很省心很简短。只需要开首化,然后设置相关属性即可。襄助先默认开首化,在需要的时候设置其样式和翻页效果翻页时间等。

纯文本滚动条,适用于广告、消息资讯等

- (ECAutoScrollBanner *)textBannerView {
    if (_textBannerView == nil) {
        _textBannerView = [ECAutoScrollBanner initTextBannerWithFrame:self.topView.bounds withTextDataSource:self.textDataArray withBannerScrollDirection:ECAutoScrollBannerScrollDirectionVertical];
        _textBannerView.delegate = self;
        _textBannerView.isAutoPaging = YES;
        _textBannerView.isHavePageControl = NO;
        _textBannerView.isInfinitePaging = YES;
        _textBannerView.isEnabledPanGestureRecognizer = NO;
        _textBannerView.autoPageInterval = 4.0f;
    }
    return _textBannerView;
}
设若急需点击跳转等,实现协议和商事章程即可,下同。
- (void)tapScrollBannerItem:(NSInteger)itemTag withObject:(id)object {
    NSLog(@"文本banner。点击了第%ld个子item,下标%ld", (long)itemTag + 1, (long)itemTag);
}

手动翻页的图样banner,本地图片

- (ECAutoScrollBanner *)imageBannerView {
    if (_imageBannerView == nil) {
        _imageBannerView = [ECAutoScrollBanner initLocalImageBannerWithFrame:CGRectMake(0, 30, self.bottomView.frame.size.width, 180) withImageDataSource:self.imageDataArray withBannerScrollDirection:ECAutoScrollBannerScrollDirectionHorizontal];
        _imageBannerView.isAutoPaging = NO;
    }
    return _imageBannerView;
}

活动翻页的图纸banner,url图片

- (ECAutoScrollBanner *)urlImageBannerVeiw {
    if (_urlImageBannerVeiw == nil) {
        UIImageView *placehodelImage = [[UIImageView alloc] initWithFrame:CGRectMake(0, 50 + 50 + 10 + 180 + 10, self.view.frame.size.width, 180)];
        placehodelImage.backgroundColor = [UIColor lightGrayColor];
        _urlImageBannerVeiw = [ECAutoScrollBanner initOnlineImageBannerWithFrame:CGRectMake(0, 50 + 50 + 10 + 180 + 10, self.view.frame.size.width, 180) withImageUrlDataSource:self.imageUrlDataArray withPlaceholderImage:placehodelImage.image withBannerScrollDirection:ECAutoScrollBannerScrollDirectionHorizontal];
        _urlImageBannerVeiw.isAutoPaging = YES;
        _urlImageBannerVeiw.isEnabledPanGestureRecognizer = YES;
        _urlImageBannerVeiw.isInfinitePaging = YES;
    }
    return _urlImageBannerVeiw;
}

手动翻页的view视图轮播

(注意:view视图类的轮播中,view的坐标是相对于cell.contentView的坐标,是contentView的子视图)
- (ECAutoScrollBanner *)viewBannerView {
    if (_viewBannerView == nil) {
        _viewBannerView = [[ECAutoScrollBanner alloc] initViewBannerWithFrame:CGRectMake(0, 20 + 180 + 20 + 180 + 20, self.view.frame.size.width, 180) withViewsDataSouce:self.viewDataArray withBannerScrollDirection:ECAutoScrollBannerScrollDirectionHorizontal];
        _viewBannerView.isAutoPaging = NO;
    }
    return _viewBannerView;
}

More 更多

相关文章