说明
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 风格指南 中指定的标准。
许可证
版权所有(C)2017 Prolific Interactive
Marker 由 Prolific Interactive 维护并赞助。许可文件中指定的条款下可以进行重新分发。