https://github.com/baozoudiudiu/cwcarousel
轮播图banner
https://github.com/baozoudiudiu/cwcarousel
banner carousel objective-c swift
Last synced: 5 months ago
JSON representation
轮播图banner
- Host: GitHub
- URL: https://github.com/baozoudiudiu/cwcarousel
- Owner: baozoudiudiu
- License: mit
- Created: 2018-05-03T15:08:33.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-10-28T06:55:44.000Z (almost 4 years ago)
- Last Synced: 2025-04-25T01:17:24.472Z (6 months ago)
- Topics: banner, carousel, objective-c, swift
- Language: Objective-C
- Homepage:
- Size: 10.9 MB
- Stars: 289
- Watchers: 6
- Forks: 56
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CWCarousel
## 基于collectionView实现的通用无限轮播图封装.
> 1. issues里面的可以重现的问题已经修复.
> 2. 部分不能重现的问题暂未处理.
> 3. 请大家提issue尽量描述详细些,最好能提供代码或者截图.请附上是OC版本还是Swift版本的问题.
> 4. 谢谢配合,大家一起进步.
> 5. 代码示例为oc代码, 项目中已有swift版本,请自行下载.
> 6. 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](https://github.com/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](https://github.com/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
* 控件实例对象创建
1. 创建flowLayout对象,设置轮播图风格
```
/**
构造方法
@param style 轮播图风格
@return 实例对象
*/
- (instancetype)initWithStyle:(CWCarouselStyle)style;
// egg:
CWFlowLayout *flowLayout = [[CWFlowLayout alloc] initWithStyle:[self styleFromTag:tag]];
```
2. 创建容器对象
```
/**
创建实例构造方法
@param frame 尺寸大小
@param delegate 代理
@param datasource 数据源
@param flowLayout 自定义flowlayout
@return 实例对象
*/
- (instancetype _Nullable )initWithFrame:(CGRect)frame
delegate:(id _Nullable)delegate
datasource:(id _Nullable)datasource
flowLayout:(nonnull CWFlowLayout *)flowLayout;
// egg:
CWCarousel *carousel = [[CWCarousel alloc] initWithFrame:self.animationView.bounds
delegate:self
datasource:self
flowLayout:flowLayout];
```
3. 注册自定义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;
}
```
4. 为了流畅性和避免概率图片位置错乱问题,当开启自动滚动时,在banner所处的控制器生命周期中需要调用以下对应方法
```
/**
轮播图所处控制器WillAppear方法里调用
*/
- (void)controllerWillAppear;
/**
轮播图所处控制器WillDisAppear方法里调用
*/
- (void)controllerWillDisAppear;
```
* 具体UI样式修改都有具体的属性,详情请查看对应类的.h文件即可.
* 如有问题和bug,欢迎指正.