KSPhotoBrowser
具有交互式消失动画的美观照片浏览器。
特性
- 4 种不同的交互式消失动画(旋转、缩放、滑动)
- 3 种不同的背景样式(模糊照片、模糊、黑色)
- 2 种不同的加载样式(确定、不确定)
- 2 种不同的页码样式(点、文本)
- 支持弹跳动画
- 优化用于高度非常大的图片
- 可以通过提供图片URL或UIImage对象来显示一张或多个图片
- 支持自定义图片下载库
- 具有圆角的平滑动画
- 支持纵向和横向设备方向
- 支持视频浏览
使用方法
从URL显示图片
NSArray *urls = @[@"https://ww4.sinaimg.cn/bmiddle/a15bd3a5jw1f12r9ku6wjj20u00mhn22.jpg",
@"https://ww2.sinaimg.cn/bmiddle/a15bd3a5jw1f01hkxyjhej20u00jzacj.jpg"];
NSMutableArray *items = @[].mutableCopy;
for (int i = 0; i < urls.count; i++) {
// Get the large image url
NSString *url = [urls[i] stringByReplacingOccurrencesOfString:@"bmiddle" withString:@"large"];
UIImageView *imageView = _imageViews[i];
KSPhotoItem *item = [KSPhotoItem itemWithSourceView:imageView imageUrl:[NSURL URLWithString:url]];
[items addObject:item];
}
KSPhotoBrowser *browser = [KSPhotoBrowser browserWithPhotoItems:items selectedIndex:0];
[browser showFromViewController:self];
从UIImage对象显示图片
NSArray *names = @[@"a.jpg", @"b.jpg"];
NSMutableArray *items = @[].mutableCopy;
for (int i = 0; i < names.count; i++) {
UIImageView *imageView = _imageViews[i];
KSPhotoItem *item = [KSPhotoItem itemWithSourceView:imageView image:[UIImage imageNamed:names[i]]];
[items addObject:item];
}
KSPhotoBrowser *browser = [KSPhotoBrowser browserWithPhotoItems:items selectedIndex:0];
[browser showFromViewController:self];
安装
Cocoapods方式
- 更新cocoapods到最新版本。
- 在Podfile中添加
pod 'KSPhotoBrowser'
。 - 运行
pod install
或pod update
。 - 导入
KSPhotoBrowser.h
。
手动方式
- 下载KSPhotoBrowser的所有文件并将源文件添加到您的项目中。
- 手动将SDWebImage安装到项目中。
- 导入
KSPhotoBrowser.h
。
自定义图片下载器
它使用SDWebImage
作为默认的图片下载器,你也可以使用自定义的图片下载器,如YYWebImage
、Kingfisher
等。
要使用自定义图片下载器,你需要创建一个类,使其遵守 KSImageManagerProtocol
并实现该协议中的方法。
为了方便,我已经创建了一个名为 KSYYImageManager
的类,以支持在演示中演示 YYWebImage
,你也可以直接使用它。
最后,在使用浏览器显示图片之前,只需使用下面的代码设置你的类为 KSPhotoBrowser
。
[KSPhotoBrowser setImageManagerClass:KSYYImageManager.class]
要求
该库需要iOS 8.0+和Xcode 8.0+。
许可协议
KSPhotoBrowser根据MIT协议提供。详细请参阅LICENSE文件。