Optik 0.4.0

Optik 0.4.0

测试已测试
Lang语言 SwiftSwift
许可证 MIT
发布最后发布2019年6月
SPM支持 SPM

Malinka SeneviratneHtin LinnQuentin Colle 维护。



Optik 0.4.0

  • 作者:
  • htinlinn

Optik

Travis build status Cocoapods Compatible Platform Docs

说明

Optik 为一系列图像提供简单的查看体验,无论这些图像存储在本地还是远程。

需求

  • iOS 9.0+
  • Xcode 8.1 或更高版本

安装

Optik 可通过 CocoaPods 获得。要安装它,只需将以下行添加到您的 Podfile

pod "Optik"

使用方法

Optik 可以用于显示本地或远程存储的图像。

显示图像

本地图像

本地图像可以通过创建一个包含多个图像的图像查看器进行显示。

let imageViewer = Optik.imageViewer(
    withImages: [
		UIImage(named: "image1.jpg")!,
		UIImage(named: "image2.jpg")!,
		UIImage(named: "image3.jpg")!
    ]
)

presentViewController(imageViewer, animated: true, completion: nil)

远程图像

对于远程图像,应提供一组NSURLs以及符合ImageDownloader协议的对象。

let imageDownloader = MyImageDownloader()

let imageViewer = Optik.imageViewer(
    withURLs: [
        NSURL(string: "https://somewebsite.com/image1.png")!,
        NSURL(string: "https://somewebsite.com/image2.png")!,
        NSURL(string: "https://somewebsite.com/image3.png")!
    ],
    imageDownloader: imageDownloader
)

presentViewController(imageViewer, animated: true, completion: nil)

自定义图像查看器

关闭按钮

可以自定义关闭按钮的图像和位置。

要指定自定义的关闭按钮图像,在创建图像查看器时提供dismissButtonImage参数。

let imageViewer = Optik.imageViewer(
    withImages: [
        UIImage(named: "image1.jpg")!
    ],
    dismissButtonImage: UIImage(named: "MyDismissButton")
)

要指定关闭按钮的位置,提供dismissButtonPosition

let imageViewer = Optik.imageViewer(
    withImages: [
        UIImage(named: "image1.jpg")!
    ],
    dismissButtonImage: UIImage(named: "MyDismissButton"),
    dismissButtonPosition: .TopTrailing
)

活动指示器

在下载远程图像时,会在图像加载期间显示活动指示器。要指定自定义的活动指示器颜色,在创建图像查看器时提供activityIndicatorColor:参数。

let imageViewer = Optik.imageViewer(
    withURLs: [
    	NSURL(string: "https://somewebsite.com/image1.png")!
    ],
    imageDownloader: imageDownloader,
    activityIndicatorColor: UIColor.redColor()
)

为 Optik 做贡献

若要报告缺陷或增强功能请求,请在相应的标题下提交问题。

如果您希望为该项目做贡献,请克隆此仓库并提交拉取请求。代码贡献应遵循 Prolific Swift 风格指南 中指定的标准。

许可证

prolific

版权所有(C)2017 Prolific Interactive

Marker 由 Prolific Interactive 维护并赞助。许可文件中指定的条款下可以进行重新分发。