iOS轮播图——SDCycleScrollView(附demo)
在此给大家推荐一个十分好用的轮播图库——SDCycleScrollView
附件demo GitHub:GitHub - dangyuhua/SDCycleScrollViewDemo
库GitHub:GitHub - gsdios/SDCycleScrollView: Autoscroll Banner. 无限循环图片、文字轮播器。
注:
1.这个库还包含了另一个优秀的图片库SDWebImage,如果项目已经集成了SDWebImage,可以把这个库里面的SDWebImage删掉,不过如果是通过Cocoapods集成可以省去这些麻烦。
2.记得在info.plist设置App Transport Security Settings
这个库可手动导入也可Cocoapods导入(demo采用的是Cocoapods导入)
下面是这个库API的简单介绍,其实也是从文件复制过来的,因为都写得很清楚了
/** 点击图片回调 */
- (void)cycleScrollView:(SDCycleScrollView*)cycleScrollView didSelectItemAtIndex:(NSInteger)index;
/** 图片滚动回调 */
- (void)cycleScrollView:(SDCycleScrollView*)cycleScrollView didScrollToIndex:(NSInteger)index;
// 不需要自定义轮播cell的请忽略以下两个的代理方法
// ========== 轮播自定义cell ==========
/** 如果你需要自定义cell样式,请在实现此代理方法返回你的自定义cell的class。 */
- (Class)customCollectionViewCellClassForCycleScrollView:(SDCycleScrollView*)view;
/** 如果你需要自定义cell样式,请在实现此代理方法返回你的自定义cell的Nib。 */
- (UINib*)customCollectionViewCellNibForCycleScrollView:(SDCycleScrollView*)view;
/** 如果你自定义了cell样式,请在实现此代理方法为你的cell填充数据以及其它一系列设置 */
- (void)setupCustomCell:(UICollectionViewCell*)cell forIndex:(NSInteger)index cycleScrollView:(SDCycleScrollView*)view;
@end
@interfaceSDCycleScrollView :UIView
/** 初始轮播图(推荐使用) */
+ (instancetype)cycleScrollViewWithFrame:(CGRect)frame delegate:(id)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;
////////////////////// 数据源API //////////////////////
/** 网络图片 url string 数组 */
@property(nonatomic,strong)NSArray*imageURLStringsGroup;
/** 每张图片对应要显示的文字数组 */
@property (nonatomic, strong) NSArray *titlesGroup;
/** 本地图片数组 */
@property(nonatomic,strong)NSArray*localizationImageNamesGroup;
////////////////////// 滚动控制API //////////////////////
/** 自动滚动间隔时间,默认2s */
@property(nonatomic,assign)CGFloatautoScrollTimeInterval;
/** 是否无限循环,默认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)(NSIntegercurrentIndex);
/** block方式监听滚动 */
@property(nonatomic,copy)void(^itemDidScrollOperationBlock)(NSIntegercurrentIndex);
/** 可以调用此方法手动控制滚动到哪一个index */
- (void)makeScrollViewScrollToIndex:(NSInteger)index;
/** 解决viewWillAppear时出现时轮播图卡在一半的问题,在控制器viewWillAppear时调用此方法 */
- (void)adjustWhenControllerViewWillAppera;
////////////////////// 自定义样式API //////////////////////
/** 轮播图片的ContentMode,默认为 UIViewContentModeScaleToFill */
@property(nonatomic,assign)UIViewContentModebannerImageViewContentMode;
/** 占位图,用于网络未加载到图片时 */
@property(nonatomic,strong)UIImage*placeholderImage;
/** 是否显示分页控件 */
@property (nonatomic, assign) BOOL showPageControl;
/** 是否在只有一张图时隐藏pagecontrol,默认为YES */
@property(nonatomic)BOOLhidesForSinglePage;
/** 只展示文字轮播 */
@property (nonatomic, assign) BOOL onlyDisplayText;
/** pagecontrol 样式,默认为动画样式 */
@property (nonatomic, assign) SDCycleScrollViewPageContolStyle pageControlStyle;
/** 分页控件位置 */
@property (nonatomic, assign) SDCycleScrollViewPageContolAliment pageControlAliment;
/** 分页控件距离轮播图的底部间距(在默认间距基础上)的偏移量 */
@property(nonatomic,assign)CGFloatpageControlBottomOffset;
/** 分页控件距离轮播图的右边间距(在默认间距基础上)的偏移量 */
@property(nonatomic,assign)CGFloatpageControlRightOffset;
/** 分页控件小圆标大小 */
@property(nonatomic,assign)CGSizepageControlDotSize;
/** 当前分页控件小圆标颜色 */
@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;
/** 轮播文字label对齐方式 */
@property(nonatomic,assign)NSTextAlignmenttitleLabelTextAlignment;
/** 滚动手势禁用(文字轮播较实用) */
- (void)disableScrollGesture;
////////////////////// 清除缓存API //////////////////////
/** 清除图片缓存(此次升级后统一使用SDWebImage管理图片加载和缓存) */
+ (void)clearImagesCache;
/** 清除图片缓存(兼容旧版本方法) */
- (void)clearCache;