搬砖

iOS轮播图——SDCycleScrollView(附demo)

2018-11-27  本文已影响1044人  哈哈哈努力加油吧

在此给大家推荐一个十分好用的轮播图库——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;

上一篇 下一篇

猜你喜欢

热点阅读