swift:无限图片轮播器
图片轮播器用处很广,什么广告投放呀,新闻头条滚动之类的,都是使用它。出于学习的目的用swift基于UICollectionView开发了一个无限循环的图片轮播器。附上Github源码以及素材地址CyclePictureView。下面是演示
适合人群
用swift写了一个无限图片轮播器,适合初学者。为了方便大家一步步自己开发,已经把开发过程中的每一个阶段都用了一个工程,当然你也可以使用git回滚。而且在功能基本完成后,花了很大的心思对代码进行重构,让代码更加符合swift的编程模式。
编码
1.完成本地图片的显示
- 创建CyclePictureView.swift这是我们图片轮播器主要的view,在这一阶段,我仅仅只是利用UIColleciotnView的流水布局效果达成了一个简单的效果。
- 创建CyclePictureCell.swift。这个是用于UIColleciotnView的cell,它代表显示的每一张图片
- 创建LocalPictureController.swift,用于测试
这一阶段十分简单,大家参照源码1.完成本地图片的显示工程应该不会有问题
2.完成网络图片的显示
- 添加了网络图片加载的功能,这里我没有自己重写图片加载过程直接调用第三方框架Kingfisher,这个框架和oc的SDWebImage十分类似。其实事后我才发现Kingfisher跟SDWebImage的差距还是有很大。如果想使用其他框架列如SDWebImage只需将CyclePictureCell中设置图片的kf_setImageWithURL改成sd_setImageWithURL。
- 创建WebPictureController.swift,用于对网络数据的测试,我提供了一个Image.plist文件,里面是一些网络图片的url和图片对应的描述。
这一阶段如果是有经验的开发者就对我实现这两种图片加载的方式感到不爽了,因为这里是可以对代码进行重构的。当然,对于初学者的我们,一定要以实现功能为主如果在项目一开始就考虑代码这样写不好,那样写不好。那么你永远可能也迈不出项目第一步,会严重拖缓开发进度。所以我们先实现功能,对于代码的重构,一个阶段一个阶段的来,或者说你啥时候实在忍不了了,那就整理代码吧。
3.完成文字显示,并暴露一些接口
- 添加了图片的描述文字,并暴露了一些接口。因为我们开发这个图片轮播器是想以后自己能够用到,而往往对于不同规格的图片轮播器,我们对于文字的大小什么的可能会不一样。所以这些属性必须提供给用户,让使用者能够自己定制。
这里需要注意一点,父控件对于子控件的布局操作最好是放在layoutSubviews,因为只有在layoutSubviews这个方式里面才能保证子控件在你希望的地方显示。这个方法在控件最终显示前会调用一次进行最后的布局,当然也不仅仅是这时候才调用,附上layoutSubviews调用时机.
1、init初始化不会触发layoutSubviews
2、addSubview会触发layoutSubviews
3、设置view的Frame会触发layoutSubviews,当然前提是frame的值设置前后发生了变化
4、滚动一个UIScrollView会触发layoutSubviews
5、旋转Screen会触发父UIView上的layoutSubviews事件
6、改变一个UIView大小的时候也会触发父UIView上的layoutSubviews事件
举个例子,就拿本项目来说,CyclePictureCell的子控件有用于显示图片的imageVIew和用于显示文字的UILabel,那么我对这两个控件的大小以及位置的设置,最好放在CyclePictureCell的layoutSubviews方法。ps:layoutSubviews一定得调用super.layoutSubviews()
4.完成无限滚动
- 完成了无限滚动,其思路说来就是让我们显示的cell"变多"。
假如我们有5张图片,UICollectionView将会准备用5个cell进行显示(当然因为循环利用的机制在,所以创建出的cell并不一定是五个)。那么当我们显示到第五张图片的时候,如果要继续显示那么,应该显示第一张图片。这时候如果强制的用UICollciontVIew的方法强制拉回第一个cell,会有一个非常难看的向左滑动的动画,而不是继续向右滚动的动画。
为了实现无限滚动,我只能把cell的数量变多,在五张图片下,我让cell有500个或者更多,但是cell显示的图片却还是只有我们设置的那五张。并且在第一次显示的时候,让显示是cell是最中间的一张。这样,就照成了无限循环的假象。而且由于循环利用的机制的存在,是不用担心效率问题的。
这里定时器的问题也需要额外注意一下。反正要又这种意识,只要用到了定时器就要担心循环引用的问题。我的习惯是在开发的过程中,把所有用到的控制器也好,自定义的view也好。我总会加上它的析构方法deinit。
5.添加PageControl
- 这里我添加了UIPageControlPageControl控件。同样值得注意的是它的frame应该在ayoutSubviews里面设置。
到达这一步,其实大概功能也都差不多了。而且代码量也有300多行了。是可以考虑对代码进行整理了(其实是我实在不能忍了)。
6整理代码,重构图片存取方式
-
将UICollectionView的数据源和代理全部放进了扩展里面。这其实也是没办法的事情,我总觉得让一个View充当数据源和代理是不符合思维逻辑的,但又找不到其他解决方式,只要放进扩展。这样让CyclePictureView这个类的本体显得没那么臃肿
-
创建AuxiliaryModels.swift文件。加载怎样的数据,以及怎样的加载数据应该不是我们的CyclePictureView关心的事情。所以CyclePictureView的职责只要把图片的数据源(url、名字)存储起来,并在cell需要的时候给他就好,至于怎么样显示加载,那是cell的事情。所以我利用ImageBox来存储图片的数据源。这里不得不感叹swift中枚举的强大。然后在下一步中,将感受到swift2.0中协议的强大。
7.添加pageControl对齐模式,并且将无限滚动功能变成协议
-
首先我是先对pageControl的功能进行了一次增强,让它的位置能够被用户所选择。于是我立即定义了一个枚举PageControlAliment来表示能够支持的对齐方式。剩下的操作无疑是在layoutSubviews中根据不同的枚举计算不同的位置。
-
PageControlAlimentProtocol:本来完成对齐模式应该分开一个工程再写的,请原谅这里我灵感来的太突然,停不下来了。我的思路是这样的:我是给pageControl添加了一个功能,然而这个功能对于CyclePictureView来说可以有也可以没有。而且这个功能也不仅仅能够用于CyclePictureView这个类,似乎是所有的拥有有UIPageControl这个控件的类(视图),都可以有这个设置UIPageControl位置的功能。于是我想到了使用协议。我要为这个功能设计一个协议,叫做PageControlAlimentProtocol,一个对齐协议。任何一个View,你只要想方便的调整自己拥有UIPageControl,只要遵守这个协议,协议便能够帮你调节控件位置。于是协议我定义成这样。
protocol PageControlAlimentProtocol: class{
var pageControlAliment: PageControlAliment {get set}
func AdjustPageControlPlace(pageControl: UIPageControl)
}
一个属性,便是开始定义的位置类型的枚举,要使用本协议,必须得提供这个属性。还有协议一个方法,是调节位置的协议方法。这里我在协议的扩展中给了它一个默认的实现。用户在任何需要改变位置的代码出直接调用即可。
- EndlessCycleProtocol:这个协议的思路和上面那个协议几乎一样。不过这个协议抽取出来感觉有点牵强。不过代码确实是简洁了。这里希望大牛们能够指点
8.进一步改进代码,并添加对storyboard的支持
- 首先是增加了CyclePictureView的代理协议CyclePictureViewDelegate,其实就是一个简单的点击事件的传递。
- 改进了一些代码的逻辑。
- 增加了对storyboard的支持,这里折腾了挺久,在从storyboard中加载的时候,不知道为什么会有莫名的偏移,找了好久才找到原因。
总结
在编码过程中,我尽量多的使用swift的特性,代码写到第五步感觉和以前oc的思维都差不多。于是我强迫自己对代码进行修改。结果虽然是写出来了不一样的代码,但是不知道有没有过度重构,希望大家能够指出不足之处。当然这个CyclePictureView图片轮播器是可以拿到任何项目中去使用的。如果您发现任何BUG,或者有更好的建议或者意见,欢迎您的指出。邮箱:wxl19950606@163.com.感谢您的支持。
网友评论
我将DEMO(web版)直接集成之后发现有轮播效果,但无法显示出图片(黑框背景),只能显示出label文字。用的就是DEMO里的image.plist,将其中
图片链接用浏览器打开后,图片能正常显示,说明图片资源没有问题。
请问会是什么问题造成轮播图中的图片无法显示?
同5楼的问题
我将DEMO(web版)直接集成之后发现有轮播效果,但无法显示出图片(黑框背景),只能显示出label文字。用的就是DEMO里的image.plist,将其中
图片链接用浏览器打开后,图片能正常显示,说明图片资源没有问题。
请问会是什么问题造成轮播图中的图片无法显示?
progressBlock: { (receivedSize, totalSize) -> () in
print("Download Progress: \(receivedSize)/\(totalSize)")
},
completionHandler: { (image, error, cacheType,imageURL) -> () in
print("Downloaded and set!, \(imageURL!)")
})
}