ZKCarousel 1.1.1

ZKCarousel 1.1.1

测试已测试
语言语言 SwiftSwift
许可协议 MIT
发布最新发布2021年9月
SPM支持 SPM

Zachary Khan 维护。



  • 作者:
  • ZacharyKhan

ZKCarousel

Swift 5.2 Version Build Status License Platform

演示

示例

要运行示例项目,请克隆仓库,然后从 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文件获取更多信息。