RFLPhotoBrowser 1.6.23

RFLPhotoBrowser 1.6.23

×

测试已测试✗
语言语言 Obj-CObjective C
许可 MIT
发布最后发布2015年9月

由 shhommatsu 维护。

 
依赖
AFNetworking>= 0
DACircularProgress>= 0
pop>= 0
 

RFLPhotoBrowser 1.6.23

  • 由
  • Ideais Mobile

IDMPhotoBrowser

IDMPhotoBrowser 是基于 MWPhotoBrowser 的新实现。

我们还添加了用户界面和技术特性，这些特性是受 Facebook 和 Tweetbot 的照片浏览器启发的。

新功能

  • 使用 ARC
  • 使用 AFNetworking 进行图片加载
  • 显示图片进度
  • 极简Facebook风格的界面，上下滑动以关闭
  • 可以自定义动作表上的动作

功能

  • 可以通过提供 UIImage 对象、设备上的图片文件路径或在线图片的URL来显示一张或多张图片
  • 无缝处理从网络下载并缓存图片
  • 图片可以缩放和拖动，并且可以显示可选的标题

截图

Alt Alt Alt Alt Alt

用法

请参阅以下代码片段以了解如何实现图片浏览器。

首先创建一个包含 IDMPhoto 对象的图片数组

// URLs array
NSArray *photosURL = @[[NSURL URLWithString:@"http://farm4.static.flickr.com/3567/3523321514_371d9ac42f_b.jpg"], 
[NSURL URLWithString:@"http://farm4.static.flickr.com/3629/3339128908_7aecabc34b_b.jpg"], 
[NSURL URLWithString:@"http://farm4.static.flickr.com/3364/3338617424_7ff836d55f_b.jpg"], 
[NSURL URLWithString:@"http://farm4.static.flickr.com/3590/3329114220_5fbc5bc92b_b.jpg"]];

// Create an array to store IDMPhoto objects
NSMutableArray *photos = [NSMutableArray new];

for (NSURL *url in photosURL) {
    IDMPhoto *photo = [IDMPhoto photoWithURL:url];
    [photos addObject:photo];
}

// Or use this constructor to receive an NSArray of IDMPhoto objects from your NSURL objects
NSArray *photos = [IDMPhoto photosWithURLs:photosURL];

有两种主要方式来展示 photoBrowser，一种是在屏幕上呈现渐变效果，另一种是从现有的视图中进行缩放效果。

使用简单的渐变过渡效果

IDMPhotoBrowser *browser = [[IDMPhotoBrowser alloc] initWithPhotos:photos];

从视图缩放效果

IDMPhotoBrowser *browser = [[IDMPhotoBrowser alloc] initWithPhotos:photos animatedFromView:sender];

当使用此动画时，可以设置 scaleImage 属性，如果视图中的图像与浏览器中将显示的图像不同，它将动态缩放它。

browser.scaleImage = buttonSender.currentImage;

使用模态视图控制器呈现

[self presentViewController:browser animated:YES completion:nil];

定制

工具栏

您可以自定义工具栏。有三个布尔属性可以设置：displayActionButton（默认为 YES）、displayArrowButton（默认为 YES）和 displayCounterLabel（默认为 NO）。如果您根本不想使用工具栏，可以将 displayToolbar 设置为 NO。

工具栏设置示例

browser.displayActionButton = NO;
browser.displayArrowButton = YES;
browser.displayCounterLabel = YES;

您可以使用自己的图像替换工具栏箭头

browser.leftArrowImage = [UIImage imageNamed:@"IDMPhotoBrowser_customArrowLeft.png"];
browser.rightArrowImage = [UIImage imageNamed:@"IDMPhotoBrowser_customArrowRight.png"];
browser.leftArrowSelectedImage = [UIImage imageNamed:@"IDMPhotoBrowser_customArrowLeftSelected.png"];
browser.rightArrowSelectedImage = [UIImage imageNamed:@"IDMPhotoBrowser_customArrowRightSelected.png"];

如果您想使用自定义操作，使用 actionButtonTitles 数组设置动作表的标题。然后，从 IDMPhotoBrowser 代理中实现 photoBrowser:didDismissActionSheetWithButtonIndex:photoIndex: 方法。

browser.actionButtonTitles = @[@"Option 1", @"Option 2", @"Option 3", @"Option 4"];

其他

您可以进行的其他自定义包括：使用白色背景颜色，不显示完成按钮以及更改完成按钮的背景图片。

browser.useWhiteBackgroundColor = YES;
browser.displayDoneButton = NO;
browser.doneBackgroundImage = [UIImage imageNamed:@"IDMPhotoBrowser_customDoneButton.png"];

在显示和隐藏照片时，您可以使用平滑的 pop 动画。

    browser.usePopAnimation = YES;

如果显示视图控制器没有状态栏，在某些情况下可以强制将其隐藏。

    browser.forceHideStatusBar = YES;

可以禁用垂直消失的滑动手势。

    browser.disableVerticalSwipe = YES;

照片标题

可以通过在指定照片上设置 caption 属性来简单地显示照片标题。

IDMPhoto *photo = [IDMPhoto photoWithFilePath:[[NSBundle mainBundle] pathForResource:@"photo2l" ofType:@"jpg"]];
photo.caption = @"Campervan";

如果没有设置标题属性，则不会显示标题。

自定义标题

默认情况下，标题是一个简单的黑色透明视图，其中包含一个标签，用于在白色中显示照片的标题。如果您想实现自己的标题视图，请遵循以下步骤

  1. 可选地使用 IDMPhoto 的子类来处理您的照片，以便存储比简单的标题字符串更多的数据。
  2. 子类化 IDMCaptionView 并重写 -setupCaption 和 -sizeThatFits:（以及您认为合适的任何其他 UIView 方法）以布局自己的视图并设置其大小。更多信息可以在 IDMCaptionView.h 中找到
  3. 实现 -photoBrowser:captionViewForPhotoAtIndex: IDMPhotoBrowser 代理方法（如下所示）。

自定义标题视图的示例代理方法

- (IDMCaptionView *)photoBrowser:(IDMPhotoBrowser *)photoBrowser captionViewForPhotoAtIndex:(NSUInteger)index {
    IDMPhoto *photo = [self.photos objectAtIndex:index];
    MyIDMCaptionViewSubclass *captionView = [[MyIDMCaptionViewSubclass alloc] initWithPhoto:photo];
    return captionView;
}

添加到您的项目中

直接将源代码包含到您的项目中

使用开源库

许可

本项目使用 MIT 许可。