菜单

iOS轮播图封装

2018年12月24日 - 注册免费送38元体验金

ECAutoScrollBanner

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

bug fix:

  1. 成立view试图类的轮播图优化修复。(注意:view视图类的轮播中,view的坐标是争持于cell.contentView的坐标,是contentView的子视图)

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

Navigation 导航

Abstract 概要

简介&特性

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

效果图

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的滑行效果。
此次封装实现思路
image
支撑手动翻页和定时翻页
补助竖向垂直翻页和水准翻页
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文件夹直接拖入项目中,导入头文件#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 更多

相关文章

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图