iOS 自定义工具类 - 图片浏览器

前言

开发过程中,遇到了需要图片浏览的功能,可以进行简单的图片浏览和网络图片保存的功能,为了方便以后使用,就封装了一个简单的图片浏览器,需要SDWebImage支持,使用:

// 显示本地图片
[PhotoBrowser showLocalImages:images selectedIndex:3];
// 显示网络图片
[PhotoBrowser showURLImages:images placeholderImage:[UIImage imageNamed:@"placeholderImage"] selectedIndex:2];

运行效果:

运行效果

思路

自定义一个视图,添加到KeyWindow上;
使用UICollectionView来展示图片,这样可以复用减少内存的消耗
可以在cell中添加一个scrollView来实现缩放功能
添加拖动手势实现图片的渐变消失


实现

步骤一:自定义视图,添加到KeyWindow上

添加动画,实现优雅出现

UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
[keyWindow addSubview:photoBrowser];
CABasicAnimation *animation = [CABasicAnimation animationWithKeyPath:@"transform.scale"];
animation.duration = 0.25f;  // 动画之行时间
animation.fromValue = @(0.0);
animation.toValue = @(1.0);
animation.removedOnCompletion = NO;
animation.fillMode = kCAFillModeForwards;
// 将动画添加到layer上
[photoBrowser.layer addAnimation:animation forKey:@"animation"];

步骤二 :使用UICollectionView

-(UICollectionView *)collectionView{
    if (_collectionView==nil) {
        UICollectionViewFlowLayout * layout = [[UICollectionViewFlowLayout alloc]init];
        // 视图的滚动方向设置为横向滚动
        layout.scrollDirection = UICollectionViewScrollDirectionHorizontal;
        layout.minimumLineSpacing = 0;
        _collectionView = [[UICollectionView alloc] initWithFrame:[UIScreen mainScreen].bounds collectionViewLayout:layout];
        _collectionView.delegate = self;
        _collectionView.dataSource = self;
        _collectionView.pagingEnabled = YES;
        _collectionView.showsHorizontalScrollIndicator = NO;
        _collectionView.showsVerticalScrollIndicator = NO;
        _collectionView.backgroundColor = [UIColor clearColor];
        [_collectionView registerClass:[PhotoBrowserCollectionViewCell class] forCellWithReuseIdentifier:@"LOLITA"];
    }
    return _collectionView;
}

每个item的尺寸需要设置为屏幕的大小

-(CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath{
    return CGSizeMake([UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height);
}

步骤三:给cell中添加scrollView,实现缩放视图

缩放视图需要实现下面的代理方法

- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView;

缩放视图时,位置中心点的调整

//控制缩放时在中心
- (void)scrollViewDidZoom:(UIScrollView *)scrollView{
    CGFloat offsetX = (scrollView.bounds.size.width > scrollView.contentSize.width)?
    (scrollView.bounds.size.width - scrollView.contentSize.width) * 0.5 : 0.0;
    CGFloat offsetY = (scrollView.bounds.size.height > scrollView.contentSize.height)?
    (scrollView.bounds.size.height - scrollView.contentSize.height) * 0.5 : 0.0;
    self.imageView.center = CGPointMake(scrollView.contentSize.width * 0.5 + offsetX,scrollView.contentSize.height * 0.5 + offsetY);
}

步骤四:给UICollectionView添加拖拽手势,实现渐变消失

UIPanGestureRecognizer *pan = [[UIPanGestureRecognizer alloc] initWithTarget:self action:@selector(handleSwipe:)];
pan.delegate = self;
[_collectionView addGestureRecognizer:pan];

重点是拖拽手势处理,因为会出现手势冲突点问题,我们需要兼容拖拽手势和CollectionView上的手势,我们需要实现手势代理

-(BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer{
    return YES;
}

这样,当我们拖拽的时候,就都可以响应了

在拖拽手势代理中:

// !!!: 手势处理
- (void)handleSwipe:(UIPanGestureRecognizer *)swipe{
    NSArray *cellArray =  self.collectionView.visibleCells;
    PhotoBrowserCollectionViewCell *cell = cellArray.firstObject;
    if (cell.scrollView.zoomScale>1||self.collectionView.isDragging) { // 如果已经是放大操作了,或者正在拖拽,则不响应手势
        return;
    }

    CGFloat hideHeight = 150.0; // 设置消失的最大滑动距离
    if (swipe.state == UIGestureRecognizerStateChanged) {
        CGPoint translation = [swipe translationInView:self.collectionView];
        CGFloat absX = fabs(translation.x);
        CGFloat absY = fabs(translation.y);
        // 设置滑动有效距离
        if (absX > absY ) { // 左右滑动
            return;
        } else if (absY > absX ) {  // 上下滑动
            // 此时需要禁掉collectionView的滚动能力
            self.collectionView.scrollEnabled = NO;
            self.bgView.alpha = (hideHeight*3 - absY)/ (hideHeight*3);
            self.backBtn.alpha = self.bgView.alpha;
            self.saveBtn.alpha = self.bgView.alpha;
            CGRect newFrame = self.collectionView.frame;
            newFrame.origin.y = translation.y;
            self.collectionView.frame = newFrame;
        }
    }
    else if (swipe.state == UIGestureRecognizerStateEnded){
        // 当手势结束,重新开启collectionView的滚动能力
        self.collectionView.scrollEnabled = YES;
        // 如果超过了最大滑动距离
        if (fabs(self.collectionView.frame.origin.y)>hideHeight) {
            [UIView animateWithDuration:0.5 animations:^{
                self.alpha = 0;
                if (self.collectionView.frame.origin.y<0) {
                    CGRect newFrame = self.collectionView.frame;
                    newFrame.origin.y = self.collectionView.frame.origin.y - self.frame.size.height;
                    self.collectionView.frame = newFrame;
                }else{
                    CGRect newFrame = self.collectionView.frame;
                    newFrame.origin.y = self.collectionView.frame.origin.y + self.frame.size.height;
                    self.collectionView.frame = newFrame;
                }
            } completion:^(BOOL finished) {
                [self removeFromSuperview];
            }];
        }else{  // 重新回复到最初位置
            [UIView animateWithDuration:0.25 animations:^{
                CGRect newFrame = self.collectionView.frame;
                newFrame.origin.y = 0;
                self.collectionView.frame = newFrame;
                self.bgView.alpha = 1;
                self.backBtn.alpha = self.bgView.alpha;
                self.saveBtn.alpha = self.bgView.alpha;
            }];
        }
    }
    
}

使用

在需要显示图片的事件里,传入图片数据

// 显示本地图片
[PhotoBrowser showLocalImages:images selectedIndex:3];
// 显示网络图片
[PhotoBrowser showURLImages:images placeholderImage:[UIImage imageNamed:@"placeholderImage"] selectedIndex:2];

Demo地址

传送门:Demo地址


总结

  • 封装工具的时候,最重要的就是使用简单,篇幅少;不太想用别人的东西最主要的就是功能复杂,很多对我来说都是冗余的,并且出现问题时也不好维护,所以如果能够自己实现就自己实现,这是对项目的负责
  • 该工具可以继续优化,例如将点击视图传进来,返回时回到最初位置,类似系统浏览图片等功能
  • 可以使用UICollectionView实现循环滚动(伪循环),思路是:利用UICollectionView的重用性,将图片数量*n次,例如1000次,并无动画滚动到中间位置,这样伪实现无限滚动视图

2018-1-30 补充

1、新增默认选择的图片
2、单击收起图片、双击放大或还原图片


2018-3-27 优化

优化展示形式:类似朋友圈
对视图进行平滑的展现和缩回
需要新增相关代理,传入对应视图,并回传结束时机

普通视图
列表视图
瀑布流视图

2018-10-22 优化

浏览器开放了手动隐藏,保存图片,识别二维码功能,新增了弹窗选择控件。

效果:

效果

使用:

实现长按代理

// !!!!: 长按手势
-(void)photoBrowser:(PhotoBrowser *)photoBrowser LongPress:(UILongPressGestureRecognizer *)longPress{
    NSMutableArray* items = [NSMutableArray array];
    PhotoPickItem* item1 = [PhotoPickItem itemWithTitle:@"保存图片" picked:^{
        [photoBrowser saveImageFromCurrentPage];
    }];
    [items addObject:item1];
    if ([photoBrowser existQRCodeFromCurrentPage]) {
        PhotoPickItem* item2 = [PhotoPickItem itemWithTitle:@"识别二维码" picked:^{
            [photoBrowser identifyQRCodeFromCurrentPage:^(NSString *result) {
                [[[UIAlertView alloc] initWithTitle:@"二维码"
                                            message:result
                                           delegate:self
                                  cancelButtonTitle:@"确定"
                                  otherButtonTitles:nil] show];
                [photoBrowser hidden];
                NSURL* url = [NSURL URLWithString:result];
                if ([[UIApplication sharedApplication] canOpenURL:url]) {
                    [[UIApplication sharedApplication] openURL:url];
                }
            }];
        }];
        [items addObject:item2];
    }
    [PhotoPickView showOnView:photoBrowser Options:items];
}

注:PhotoPickView 是一个弹出选择视图的类,可以加到其他视图上。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342

推荐阅读更多精彩内容

  • 1、通过CocoaPods安装项目名称项目信息 AFNetworking网络请求组件 FMDB本地数据库组件 SD...
    阳明先生_x阅读 15,967评论 3 119
  • 给你霜雪夜的孤月 故园早梅的冷香 给你一条荒僻的小径 一盏飘摇的灯火 花窗朱漆绵延出细腻的纹络 桌上茶盏残茶枯落 ...
    糖不甜了阅读 223评论 0 7
  • “八仙之首”吕洞宾落榜不落志 柳哲 一年一度高考季,一条条雷人的新闻刷爆媒体圈,关键时刻,一个小小的失误,都关乎于...
    柳志儒阅读 213评论 1 1
  • 目录 上一篇 江辰做了一个太真实的梦,他觉得与七梦有关,于是再次前往奶奶家。 到奶奶家的时候,时间刚好八点。猫族向...
    刘白月阅读 206评论 0 1