ZKCarousel
演示
示例
要运行示例项目,请克隆仓库,然后从 Example 目录运行 pod install
。然后,打开 .xcworkspace
并在 Xcode 中运行项目。
安装
ZKCarousel 可通过 CocoaPods 使用。要安装它,只需将以下行添加到您的 Podfile 中:
pod 'ZKCarousel'
然后,切换到包含您的 podfile
的目录,运行 pod install
用法
ZKCarousel
可以通过编程方式或通过Storyboard进行实例化。
Storyboard
请参考示例项目,了解如何使用Storyboard与ZKCarousel
配合使用。
编程方式
import UIKit
import ZKCarousel
class ViewController : UIViewController {
let carousel : ZKCarousel = {
let carousel = ZKCarousel()
// Create as many slides as you'd like to show in the carousel
let slide = ZKCarouselSlide(image: UIImage(), title: "Hello There 👻", description: "Welcome to the ZKCarousel demo! Swipe left to view more slides!")
let slide1 = ZKCarouselSlide(image: UIImage(), title: "A Demo Slide ☝🏼", description: "lorem ipsum devornum cora fusoa foen sdie ha odab ebakldf shjbesd ljkhf")
let slide2 = ZKCarouselSlide(image: UIImage(), title: "Another Demo Slide ✌🏼", description: "lorem ipsum devornum cora fusoa foen ebakldf shjbesd ljkhf")
// Add the slides to the carousel
carousel.slides = [slide, slide1, slide2]
return carousel
}()
override func viewDidLoad() {
super.viewDidLoad()
carousel.frame = CGRect()
view.addSubView(self.carousel)
}
}
自动切换幻灯片
您可以选择让ZKCarousel自动切换幻灯片。您只需在ZKCarousel上使用start()
和stop()
函数。您还可以通过设置interval
属性来设置幻灯片之间的时间间隔。默认间隔为2秒。
请参考示例以了解这一功能的实现方式。
自定义手势识别器
如果您想在点击轮播图时执行自定义操作(而不是默认操作,即切换到下一张幻灯片),您首先需要调用disableTap()
以移除默认的手势识别器,然后将您自己的手势识别器添加到UICollectionView中。
贡献
如果你有兴趣为 ZKCarousel 做贡献,请Fork仓库并提交一个pull request。所有贡献都受欢迎和鼓励! :)
对于所有错误报告、功能请求等,请向仓库提交一个Issue。
许可证
ZKCarousel遵循MIT许可证。请查看LICENSE文件获取更多信息。