KSPhotoBrowser 0.3.1

KSPhotoBrowser 0.3.1

测试已验证
语言语言 Obj-CObjective C
许可 MIT
发布上次发布2020年10月

Kyle Sun 维护。



KSPhotoBrowser

License MIT  CocoaPods  CocoaPods  Support 

具有交互式消失动画的美观照片浏览器。

Rotation~ Blur~ Scale~ Corner~ Orientation~ Index~

特性

  • 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方式

  1. 更新cocoapods到最新版本。
  2. 在Podfile中添加pod 'KSPhotoBrowser'
  3. 运行pod installpod update
  4. 导入KSPhotoBrowser.h

手动方式

  1. 下载KSPhotoBrowser的所有文件并将源文件添加到您的项目中。
  2. 手动将SDWebImage安装到项目中。
  3. 导入KSPhotoBrowser.h

自定义图片下载器

它使用SDWebImage作为默认的图片下载器,你也可以使用自定义的图片下载器,如YYWebImageKingfisher等。

要使用自定义图片下载器,你需要创建一个类,使其遵守 KSImageManagerProtocol并实现该协议中的方法。

为了方便,我已经创建了一个名为 KSYYImageManager的类,以支持在演示中演示 YYWebImage,你也可以直接使用它。

最后,在使用浏览器显示图片之前,只需使用下面的代码设置你的类为 KSPhotoBrowser

[KSPhotoBrowser setImageManagerClass:KSYYImageManager.class]

要求

该库需要iOS 8.0+和Xcode 8.0+。

许可协议

KSPhotoBrowser根据MIT协议提供。详细请参阅LICENSE文件。