iOS：实现图片的无限轮播－－－之使用第三方库SDCycleScrollView

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

SDCycleScrollView API

//

//  SDCycleScrollView.h

//  SDCycleScrollView

#import <UIKit/UIKit.h>

typedef enum {

SDCycleScrollViewPageContolAlimentRight,

SDCycleScrollViewPageContolAlimentCenter

} SDCycleScrollViewPageContolAliment;

typedef enum {

SDCycleScrollViewPageContolStyleClassic,        // 系统自带经典样式

SDCycleScrollViewPageContolStyleAnimated,       // 动画效果pagecontrol

SDCycleScrollViewPageContolStyleNone            // 不显示pagecontrol

} SDCycleScrollViewPageContolStyle;

@class SDCycleScrollView;

@protocol SDCycleScrollViewDelegate <NSObject>

@optional

/** 点击图片回调 */

- (void)cycleScrollView:(SDCycleScrollView *)cycleScrollView didSelectItemAtIndex:(NSInteger)index;

/** 图片滚动回调 */

- (void)cycleScrollView:(SDCycleScrollView *)cycleScrollView didScrollToIndex:(NSInteger)index;

@end

@interface SDCycleScrollView : UIView

/** 初始轮播图（推荐使用） */

+ (instancetype)cycleScrollViewWithFrame:(CGRect)frame delegate:(id<SDCycleScrollViewDelegate>)delegate placeholderImage:(UIImage *)placeholderImage;

+ (instancetype)cycleScrollViewWithFrame:(CGRect)frame imageURLStringsGroup:(NSArray *)imageURLStringsGroup;

/** 本地图片轮播初始化方式 */

+ (instancetype)cycleScrollViewWithFrame:(CGRect)frame imageNamesGroup:(NSArray *)imageNamesGroup;

/** 本地图片轮播初始化方式2,infiniteLoop:是否无限循环 */

+ (instancetype)cycleScrollViewWithFrame:(CGRect)frame shouldInfiniteLoop:(BOOL)infiniteLoop imageNamesGroup:(NSArray *)imageNamesGroup;

//////////////////////  数据源接口  //////////////////////

/** 网络图片 url string 数组 */

@property (nonatomic, strong) NSArray *imageURLStringsGroup;

/** 每张图片对应要显示的文字数组 */

@property (nonatomic, strong) NSArray *titlesGroup;

/** 本地图片数组 */

@property (nonatomic, strong) NSArray *localizationImageNamesGroup;

//////////////////////  滚动控制接口 //////////////////////

/** 自动滚动间隔时间,默认2s */

@property (nonatomic, assign) CGFloat autoScrollTimeInterval;

/** 是否无限循环,默认Yes */

@property (nonatomic,assign) BOOL infiniteLoop;

/** 是否自动滚动,默认Yes */

@property (nonatomic,assign) BOOL autoScroll;

/** 图片滚动方向，默认为水平滚动 */

@property (nonatomic, assign) UICollectionViewScrollDirection scrollDirection;

@property (nonatomic, weak) id<SDCycleScrollViewDelegate> delegate;

/** block方式监听点击 */

@property (nonatomic, copy) void (^clickItemOperationBlock)(NSInteger currentIndex);

/** block方式监听滚动 */

@property (nonatomic, copy) void (^itemDidScrollOperationBlock)(NSInteger currentIndex);

/** 解决viewWillAppear时出现时轮播图卡在一半的问题，在控制器viewWillAppear时调用此方法 */

- (void)adjustWhenControllerViewWillAppera;

//////////////////////  自定义样式接口  //////////////////////

/** 轮播图片的ContentMode，默认为 UIViewContentModeScaleToFill */

@property (nonatomic, assign) UIViewContentMode bannerImageViewContentMode;

/** 占位图，用于网络未加载到图片时 */

@property (nonatomic, strong) UIImage *placeholderImage;

/** 是否显示分页控件 */

@property (nonatomic, assign) BOOL showPageControl;

/** 是否在只有一张图时隐藏pagecontrol，默认为YES */

@property(nonatomic) BOOL hidesForSinglePage;

/** 只展示文字轮播 */

@property (nonatomic, assign) BOOL onlyDisplayText;

/** pagecontrol 样式，默认为动画样式 */

@property (nonatomic, assign) SDCycleScrollViewPageContolStyle pageControlStyle;

/** 分页控件位置 */

@property (nonatomic, assign) SDCycleScrollViewPageContolAliment pageControlAliment;

/** 分页控件距离轮播图的底部间距（在默认间距基础上）的偏移量 */

@property (nonatomic, assign) CGFloat pageControlBottomOffset;

/** 分页控件距离轮播图的右边间距（在默认间距基础上）的偏移量 */

@property (nonatomic, assign) CGFloat pageControlRightOffset;

/** 分页控件小圆标大小 */

@property (nonatomic, assign) CGSize pageControlDotSize;

/** 当前分页控件小圆标颜色 */

@property (nonatomic, strong) UIColor *currentPageDotColor;

/** 其他分页控件小圆标颜色 */

@property (nonatomic, strong) UIColor *pageDotColor;

/** 当前分页控件小圆标图片 */

@property (nonatomic, strong) UIImage *currentPageDotImage;

/** 其他分页控件小圆标图片 */

@property (nonatomic, strong) UIImage *pageDotImage;

/** 轮播文字label字体颜色 */

@property (nonatomic, strong) UIColor *titleLabelTextColor;

/** 轮播文字label字体大小 */

@property (nonatomic, strong) UIFont  *titleLabelTextFont;

/** 轮播文字label背景颜色 */

@property (nonatomic, strong) UIColor *titleLabelBackgroundColor;

/** 轮播文字label高度 */

@property (nonatomic, assign) CGFloat titleLabelHeight;

//////////////////////  清除缓存接口  //////////////////////

/** 清除图片缓存（此次升级后统一使用SDWebImage管理图片加载和缓存）  */

+ (void)clearImagesCache;

/** 清除图片缓存（兼容旧版本方法） */

- (void)clearCache;

@end

说明

下载链接：github不断更新地址：https://github.com/gsdios/SDCycleScrollView

使用原理：采用UICollectionView的重用机制和循环滚动的方式实现图片的无限轮播，播放非常顺畅，解决了UISCrollView使用时从最后一张跳到第一张时的生硬状态。

主要类截图：

SDCollectionViewCell:用来重用的item，即显示图片的视图；

SDCycleScrollView: 对外提供的一个创建轮播器的接口类，使用者就是直接使用这个类来实现图片轮播的；

：这几个类主要是用来处理分页节点的，可以使用默认的原点分页节点，也可以使用图片节点；

TAPageControl:顾名思义，可知这个是用来设置分页的；

：一个简化使用视图frame结构体及其结构体中属性的视图分类。