Latest 1.0.0
Homepage https://github.com/tobevoid/TBVImageBrowser
License MIT
Platforms ios 8.0
Dependencies ReactiveObjC, TBVLogger

兼容本地资源、相册资源、网络资源的图片浏览器。
详情博客

如何使用

pod 'TBVImageBrowser'

使用默认Provider

本地资源
NSString *fileName = [NSString stringWithFormat:@"%@", @(i)];
NSURL *URL = [[NSBundle mainBundle] URLForResource:fileName withExtension:@"png"];
TBVImageElement *element = [TBVImageElement elementWithIdentifier:kTBVLocalImageProviderIdentifier resource:URL];
[self.elements addObject:element];
相册资源
@weakify(self)
    [[[[self.pickerManager requestCameraRollCollection] map:^id(id value) {
        @strongify(self)
        return [self.pickerManager requestAssetsForCollection:value mediaType:TBVAssetsMediaTypeImage];
    }] switchToLatest] subscribeNext:^(NSArray *assets) {
        [assets enumerateObjectsUsingBlock:^(id  _Nonnull asset, NSUInteger idx, BOOL * _Nonnull stop) {
            @strongify(self)
            TBVImageElement *element = [TBVImageElement elementWithIdentifier:kTBVAssetImageProviderIdentifier resource:asset];
            [self.elements addObject:element];
            if (idx > 5) *stop = YES;
        }];
    }];
网络资源(SDWebImage)
NSArray *URLStrings = @[
@"https://d13yacurqjgara.cloudfront.net/users/26059/screenshots/2047158/beerhenge.jpg",
@"https://d13yacurqjgara.cloudfront.net/users/26059/screenshots/2016158/avalanche.jpg",
@"https://d13yacurqjgara.cloudfront.net/users/26059/screenshots/1839353/pilsner.jpg",
@"https://d13yacurqjgara.cloudfront.net/users/26059/screenshots/1833469/porter.jpg",
@"https://d13yacurqjgara.cloudfront.net/users/26059/screenshots/1521183/farmers.jpg"
];

for (NSString *URLString in URLStrings) {
    NSURL *URL = [NSURL URLWithString:URLString];
    TBVImageElement *element = [TBVImageElement elementWithIdentifier:kTBVWebImageProviderIdentifier resource:URL];
    [self.elements addObject:element];
}

自定义图片获取策略(Provider)

比如不使用SDWebImage,改用YYWebImage或者Kingfisher;不使用TBVAssetsReformer,使用自定义相册refomer。

步骤
  • 声明Provider类,并遵守TBVImageProviderProtocol
  • 设置Provider的唯一标志符,如
- (NSString *)identifier {
    return kTBVWebImageProviderIdentifier;
}
  • 设置获取照片回调,如:
- (RACSignal *)imageSignalForElement:(id<TBVImageElementProtocol>)element progress:(TBVImageProviderProgressBlock)progress {
    @weakify(self)
    return [[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
        @strongify(self)
        id <SDWebImageOperation> operation = nil;
        if ([element.resource isKindOfClass:[NSURL class]] &&
            [[[(NSURL *)element.resource scheme] lowercaseString] containsString:@"http"]) {
            operation = [self.downloadManager downloadImageWithURL:(NSURL *)element.resource
                                                           options:SDWebImageRetryFailed
                                                          progress:^(NSInteger receivedSize, NSInteger expectedSize) {
                                                              progress(receivedSize / (CGFloat)expectedSize);
                                                          }
                                                         completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
                if (error) {
                    [subscriber sendError:error];
                } else {
                    [subscriber sendNext:image];
                    [subscriber sendCompleted];
                }
            }];
        } else {
            NSString *message = [NSString stringWithFormat:@"the resource of elememt(%@) is not a web url.", element.resource];
            [subscriber sendError:[NSError errorWithDomain:@"TBVWebImageProvider" message:message]];
        }
        return [RACDisposable disposableWithBlock:^{
            [operation cancel];
        }];
    }] deliverOnMainThread];
}
  • 向TBVImageProviderManager注册Provider对象,如
[self addImageProvider:[[TBVWebImageProvider alloc] init]];
  • 创建Element时设置此元素对应的Provider唯一标志符,如
TBVImageElement *element = [TBVImageElement elementWithIdentifier:kTBVWebImageProviderIdentifier resource:URL];

自定义Progress

由于实际项目中可以已经有一款progress控件了,所以TBVImageBrowser并没有强制要求依赖已有的progress控件,比如DACircularProgress。
开发者可以自定义progress控件。以DACircularProgress为例:

  • 创建TBVImageBrowserConfiguration,并设置progressPresenterClass为progress控件对应的类
_configuration = [TBVImageBrowserConfiguration defaultConfiguration];
_configuration.progressPresenterClass = [DALabeledCircularProgressView class];
  • 创建DACircularProgress分类,并遵守TBVImageProgressPresenterProtocol协议
@implementation DALabeledCircularProgressView (TBVImageProgressPresenter)
+ (instancetype)presenter {
    DALabeledCircularProgressView *progressView = [[DALabeledCircularProgressView alloc] initWithFrame:CGRectMake(0, 0, 40, 40)];
    progressView.thicknessRatio = 0.1;
    progressView.progressLabel.textColor = [UIColor whiteColor];
    progressView.progressLabel.font = [UIFont systemFontOfSize:12];
    progressView.userInteractionEnabled = NO;
    return progressView;
}

- (void)setPresenterProgress:(CGFloat)progress animated:(BOOL)animated {
    [self setProgress:progress animated:animated];
    TBVLogDebug(@"progress %f", progress);
    self.progressLabel.text = [NSString stringWithFormat:@"%.02f", progress];
}
@end

以上两步就可以给图片浏览器引入自己的progress控件了。
对progress控件的要求:

  • 是UIView或其子类
  • 遵守TBVImageProgressPresenterProtocol协议

Latest podspec

{
    "name": "TBVImageBrowser",
    "version": "1.0.0",
    "summary": "A image browser which has strong extendibility.",
    "homepage": "https://github.com/tobevoid/TBVImageBrowser",
    "documentation_url": "https://github.com/tobevoid/TBVImageBrowser",
    "license": {
        "type": "MIT"
    },
    "authors": "tripleCC",
    "source": {
        "git": "https://github.com/tobevoid/TBVImageBrowser.git",
        "tag": "1.0.0"
    },
    "source_files": "TBVImageBrowser/TBVImageBrowser/**/*",
    "platforms": {
        "ios": "8.0"
    },
    "dependencies": {
        "ReactiveObjC": [
            "~> 3.0"
        ],
        "TBVLogger": [
            "~> 1.0"
        ]
    }
}

Pin It on Pinterest

Share This