CWCarousel
基于collectionView实现的通用无限轮播图封装.
- issues里面的可以重现的问题已经修复.
- 部分不能重现的问题暂未处理.
- 请大家提issue尽量描述详细些,最好能提供代码或者截图.请附上是OC版本还是Swift版本的问题.
- 谢谢配合,大家一起进步.
- 代码示例为oc代码, 项目中已有swift版本,请自行下载.
- oc版本支持cocoaPods安装
pod search OC_CWCarousel
oc版和swift是两份完全不同的代码，所以代码实现不尽相同。有些可能在其中一个版本实现了，但是另一个版本不一定来得及实现。请参照下面的版本记录自行了解：
OC：版本记录
| 版本号 | 更新内容 |
|---|---|
| 1.1.9 | 1、采用 NSTimer + NSProxy方式实现自动轮播，外部可以无需再手动调用releaseTimer方法来释放内存了。 2、优化了scrollToIndex内部实现 3、修改pageControl布局代理的触发逻辑 |
| 1.1.8 | 1. 代码重构。 2. 计算间距算法修改，更好更简单的设置间距。 3. 新增代理回调： - (void)CWCarousel:(CWCarousel*)carousel addPageControl:(UIView* )pageControl;可以在该回调中自定义布局pageControl。4. 新增滚动到指定位置方法： - (void*scrollTo:(NSInteger)index animation:(BOOL)animation;。5. 废弃了 maxScale属性。6.优化了自定义pageControl的实现。 7.修改了演示demo首页样式和逻辑。 |
| 1.1.7 | 适配iOS14 感谢milletZZ |
| 1.1.5 | 1.新增了2个代理回调 2.点击事件代理回调逻辑优化 |
| 1.1.4 | 修复样式3在320尺寸屏幕上可能出现的问题 |
| 1.1.3 | 提升了一个版本号 |
| 1.1.2 | 控件优化 |
| 1.1.1 | 添加了无限轮播功能开关 endless |
| 1.1.0 | 修复了之前的一些bug |
swift：版本记录
| 版本号 | 更新内容 |
|---|---|
| 1.1.9 | 1、代码重构 2、timer实现方式优化，外部无需手动调用releaseTimer释放内存 3、计算间距算法修改，更好更简单的设置间距 4、新增滚动到指定位置方法 |
| 1.1.8 | 1.fix bug，2. 自定义pageControl优化， 3.只有一张图时不可无限滑动， 4.无数据时可以设置占位视图 |
| 1.1.7 | 适配iOS14 感谢milletZZ |
| 1.1.4 | 修复通过layout创建视图,偶现不自动轮播问题. |
| 1.1.3 | 适配swift5.0 |
| 1.1.2 | 修复样式3在320尺寸屏幕上可能出现的问题 |
| 1.1.1 | 添加了无限轮播功能开关 endless |
| 1.1.0 | 功能同OC版 1.1.0 |
- 目前支持4种样式
typedef NS_ENUM(NSUInteger, CWCarouselStyle) {
CWCarouselStyle_Unknow = 0, ///<未知样式
CWCarouselStyle_Normal, ///<普通样式,一张图占用整个屏幕宽度
CWCarouselStyle_H_1, ///<自定义样式一, 中间一张居中,前后2张图有部分内容在屏幕内可以预览到
CWCarouselStyle_H_2, ///<自定义样式二, 中间一张居中,前后2张图有部分内容在屏幕内可以预览到,并且中间一张图正常大小,前后2张图会缩放
CWCarouselStyle_H_3, ///<自定义样式三, 中间一张居中,前后2张图有部分内容在屏幕内可以预览到,中间一张有放大效果,前后2张正常大小
};
CWCarouselStyle_Normal
CWCarouselStyle_H_1
CWCarouselStyle_H_2
CWCarouselStyle_H_3
- 控件实例对象创建
- 创建flowLayout对象,设置轮播图风格
/**
构造方法
@param style 轮播图风格
@return 实例对象
*/
- (instancetype)initWithStyle:(CWCarouselStyle)style;
// egg:
CWFlowLayout *flowLayout = [[CWFlowLayout alloc] initWithStyle:[self styleFromTag:tag]];
- 创建容器对象
/**
创建实例构造方法
@param frame 尺寸大小
@param delegate 代理
@param datasource 数据源
@param flowLayout 自定义flowlayout
@return 实例对象
*/
- (instancetype _Nullable )initWithFrame:(CGRect)frame
delegate:(id<CWCarouselDelegate> _Nullable)delegate
datasource:(id<CWCarouselDatasource> _Nullable)datasource
flowLayout:(nonnull CWFlowLayout *)flowLayout;
// egg:
CWCarousel *carousel = [[CWCarousel alloc] initWithFrame:self.animationView.bounds
delegate:self
datasource:self
flowLayout:flowLayout];
- 注册自定义cell,并实现代理方法,刷新视图
[carousel registerViewClass:[UICollectionViewCell class] identifier:@"cellId"];
[carousel freshCarousel];
#pragma mark - Delegate
// 每个轮播图cell样式
- (UICollectionViewCell *)viewForCarousel:(CWCarousel *)carousel indexPath:(NSIndexPath *)indexPath index:(NSInteger)index{
UICollectionViewCell *cell = [carousel.carouselView dequeueReusableCellWithReuseIdentifier:@"cellId" forIndexPath:indexPath];
/*
your code
*/
return cell;
}
// 点击代理回调
- (void)CWCarousel:(CWCarousel *)carousel didSelectedAtIndex:(NSInteger)index {
NSLog(@"...%ld...", index);
}
// 轮播图个数
- (NSInteger)numbersForCarousel {
return kCount;
}
- 为了流畅性和避免概率图片位置错乱问题,当开启自动滚动时,在banner所处的控制器生命周期中需要调用以下对应方法
/**
轮播图所处控制器WillAppear方法里调用
*/
- (void)controllerWillAppear;
/**
轮播图所处控制器WillDisAppear方法里调用
*/
- (void)controllerWillDisAppear;
- 具体UI样式修改都有具体的属性,详情请查看对应类的.h文件即可.
- 如有问题和bug,欢迎指正.