轮播图片 高效图片轮播,两个imageView实现

时间:2024-10-08 19:06:44

该轮播框架的优势:

  • 文件少,代码简洁
  • 不依赖任何其他第三方库,耦合度低
  • 同时支持本地图片及网络图片
  • 可修改分页控件位置,显示或隐藏
  • 自定义分页控件的图片,就是这么个性
  • 自带图片缓存,一次加载,永久使用
  • 性能好,占用内存少,轮播流畅

实际使用

我们先看demo,代码如下

轮播图片 高效图片轮播,两个imageView实现

运行效果

轮播图片 高效图片轮播,两个imageView实现

轮播实现步骤

接下来,笔者将从各方面逐一分析。

层级结构

最底层是一个UIView,上面有一个UIScrollView以及UIPageControl,scrollView上有两个UIImageView,imageView宽高 = scrollview宽高 = view宽高

轮播图片 高效图片轮播,两个imageView实现

轮播原理

假设轮播控件的宽度为x高度为y,我们设置scrollview的contentSize.width为3x,并让scrollview的水平偏移量为x,既显示最中间内容

  1. scrollView.contentSize = CGSizeMake(3x, y);
  2. scrollView.contentOffset = CGPointMake(x, 0);

轮播图片 高效图片轮播,两个imageView实现

将imageView添加到scrollview内容视图的中间位置

轮播图片 高效图片轮播,两个imageView实现

接下来使用代理方法scrollViewDidScroll来监听scrollview的滚动,定义一个枚举变量来记录滚动的方向

  1. typedef enum{
  2. DirecNone,
  3. DirecLeft,
  4. DirecRight
  5. } Direction;@property (nonatomic, assign) Direction direction;
  6. - (void)scrollViewDidScroll:(UIScrollView *)scrollView {  self.direction = scrollView.contentOffset.x >x? DirecLeft : DirecRight;
  7. }

使用KVO来监听direction属性值的改变

  1. [self addObserver:self forKeyPath:@"direction" options:NSKeyValueObservingOptionNew context:nil];

判断滚动的方向,当偏移量大于x,表示左移,则将otherImageView加在右边,偏移量小于x,表示右移,则将otherImageView加在左边

轮播图片 高效图片轮播,两个imageView实现

  1. - (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context {   //self.currIndex表示当前显示图片的索引,self.nextIndex表示将要显示图片的索引
  2. //_images为图片数组
  3. if(change[NSKeyValueChangeNewKey] == change[NSKeyValueChangeOldKey]) return;  if ([change[NSKeyValueChangeNewKey] intValue] == DirecRight) {    self.otherImageView.frame = CGRectMake(0, 0, self.width, self.height);    selfself.nextIndex = self.currIndex - 1;    if (self.nextIndex < 0) self.nextIndex = _images.count – 1;
  4. } else if ([change[NSKeyValueChangeNewKey] intValue] == DirecLeft){    self.otherImageView.frame = CGRectMake(CGRectGetMaxX(_currImageView.frame), 0, self.width, self.height);    self.nextIndex = (self.currIndex + 1) % _images.count;
  5. }  selfself.otherImageView.image = self.images[self.nextIndex];
  6. }

通过代理方法scrollViewDidEndDecelerating来监听滚动结束,结束后,会变成以下两种情况:

轮播图片 高效图片轮播,两个imageView实现

此时,scrollview的偏移量为0或者2x,我们通过代码再次将scrollview的偏移量设置为x,并将currImageView的图片修改为otherImageView的图片

  1. - (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
  2. [self pauseScroll];
  3. }
  4. - (void)pauseScroll {  self.direction = DirecNone;//清空滚动方向
  5. //判断最终是滚到了右边还是左边
  6. int index = self.scrollView.contentOffset.x / x;  if (index == 1) return; //等于1表示最后没有滚动,返回不做任何操作
  7. selfself.currIndex = self.nextIndex;//当前图片索引改变
  8. selfself.pageControl.currentPage = self.currIndex;  self.currImageView.frame = CGRectMake(x, 0, x, y);  selfself.currImageView.image = self.otherImageView.image;  self.scrollView.contentOffset = CGPointMake(x, 0);
  9. }

那么我们看到的还是currImageView,只不过展示的是下一张图片,如图,又变成了最初的效果

轮播图片 高效图片轮播,两个imageView实现

自动滚动

轮播的功能实现了,接下来添加定时器让它自动滚动,相当简单

  1. - (void)startTimer {   //如果只有一张图片,则直接返回,不开启定时器
  2. if (_images.count <= 1) return;   //如果定时器已开启,先停止再重新开启
  3. if (self.timer) [self stopTimer];   self.timer = [NSTimer timerWithTimeInterval:self.time target:self selector:@selector(nextPage) userInfo:nil repeats:YES];
  4. [[NSRunLoop currentRunLoop] addTimer:self.timer forMode:NSRunLoopCommonModes];
  5. }
  6. - (void)nextPage {    //动画改变scrollview的偏移量就可以实现自动滚动
  7. [self.scrollView setContentOffset:CGPointMake(self.width * 2, 0) animated:YES];
  8. }

注意:setContentOffset:animated:方法执行完毕后不会调用scrollview的scrollViewDidEndDecelerating方法,但是会调用scrollViewDidEndScrollingAnimation方法,因此我们要在该方法中调用pauseScroll

  1. - (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView {
  2. [self pauseScroll];
  3. }

拖拽时停止自动滚动

当我们手动拖拽图片时,需要停止自动滚动,此时我们只需要让定时器失效就行了,当停止拖拽时,重新启动定时器

  1. - (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {
  2. [self.timer invalidate];
  3. }
  4. - (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate{
  5. [self startTimer];
  6. }

加载图片

实际开发中,我们很少会轮播本地图片,大部分都是服务器获取的,也有可能既有本地图片,也有网络图片,那要如何来加载呢?

定义4个属性

  • NSArray imageArray:暴露在.h文件中,外界将要加载的图片或路径数组赋值给该属性
  • NSMutableArray images:用来存放图片的数组
  • NSMutableDictionary imageDic:用来缓存图片的字典,key为URL
  • NSMutableDictionary operationDic:用来保存下载操作的字典,key为URL

判断外界传入的是图片还是路径,如果是图片,直接加入图片数组中,如果是路径,先添加一个占位图片,然后根据路径去下载图片

  1. _images = [NSMutableArray array];for (int i = 0; i < imageArray.count; i++) {    if ([imageArray[i] isKindOfClass:[UIImage class]]) {
  2. [_images addObject:imageArray[i]];//如果是图片,直接添加到images中
  3. } else if ([imageArray[i] isKindOfClass:[NSString class]]){
  4. [_images addObject:[UIImage imageNamed:@"placeholder"]];//如果是路径,添加一个占位图片到images中
  5. [self downloadImages:i];  //下载网络图片
  6. }
  7. }

下载图片,先从缓存中取,如果有,则替换之前的占位图片,如果没有,去沙盒中取,如果有,替换占位图片,并添加到缓存中,如果没有,开启异步线程下载

  1. - (void)downloadImages:(int)index {  NSString *key = _imageArray[index];  //从字典缓存中取图片
  2. UIImage *image = [self.imageDic objectForKey:key];  if (image) {
  3. _images[index] = image;//如果图片存在,则直接替换之前的占位图片
  4. }else{    //字典中没有从沙盒中取图片
  5. NSString *cache = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];    NSString *path = [cache stringByAppendingPathComponent:[key lastPathComponent]];    NSData *data = [NSData dataWithContentsOfFile:path];    if (data) {             //沙盒中有,替换占位图片,并加入字典缓存中
  6. image = [UIImage imageWithData:data];
  7. _images[index] = image;
  8. [self.imageDic setObject:image forKey:key];
  9. }else{       //字典沙盒都没有,下载图片
  10. NSBlockOperation *download = [self.operationDic objectForKey:key];//查看下载操作是否存在
  11. if (!download) {//不存在
  12. //创建一个队列,默认为并发队列
  13. NSOperationQueue *queue = [[NSOperationQueue alloc] init];        //创建一个下载操作
  14. download = [NSBlockOperation blockOperationWithBlock:^{          NSURL *url = [NSURL URLWithString:key];          NSData *data = [NSData dataWithContentsOfURL:url];           if (data) {                        //下载完成后,替换占位图片,存入字典并写入沙盒,将下载操作从字典中移除掉
  15. UIImage *image = [UIImage imageWithData:data];
  16. [self.imageDic setObject:image forKey:key];            self.images[index] = image;                        //如果只有一张图片,需要在主线程主动去修改currImageView的值
  17. if (_images.count == 1) [_currImageView performSelectorOnMainThread:@selector(setImage:) withObject:image waitUntilDone:NO];
  18. [data writeToFile:path atomically:YES];
  19. [self.operationDic removeObjectForKey:key];
  20. }
  21. }];
  22. [queue addOperation:download];
  23. [self.operationDic setObject:download forKey:key];//将下载操作加入字典
  24. }
  25. }
  26. }
  27. }

监听图片点击

当图片被点击的时候,我们往往需要执行某些操作,因此需要监听图片的点击,思路如下

1.定义一个block属性暴露给外界void(^imageClickBlock)(NSInteger index)

(不会block的可以用代理,或者看这里)

2.设置currImageView的userInteractionEnabled为YES

3.给currImageView添加一个点击的手势

4.在手势方法里调用block,并传入图片索引

结束语

上面是笔者的主要思路以及部分代码,需要源码的请前往笔者的github下载:https://github.com/codingZero/XRCarouselView。

写了这么多年的轮播图片的功能,这次居然总结的这么到位,果断收藏了。