高仿QQ微信效果的图片浏览器（支持原图和缩略图多种手势CocoaPods）

Posted 2021-04-30 二进制小镇

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了高仿QQ微信效果的图片浏览器（支持原图和缩略图多种手势CocoaPods）相关的知识，希望对你有一定的参考价值。

原文链接:
https://github.com/iphone5solo/PYPhotoBrowser

原文作者 : CoderKo1o

PYPhotoBrowser

Framework with a simple method of rendering images.
用法简单的呈现一组图片的框架。

Getting Started

框架使用

效果图

图片已发布（网络图片浏览、流水布局)

图片未发布（本地图片上传\发布\预览）

支持哪些状态

已发布（网络图片浏览）

高仿QQ、微信效果的图片浏览器（支持原图和缩略图、多种手势、CocoaPods）

未发布（本地图片上传\发布\预览）

高仿QQ、微信效果的图片浏览器（支持原图和缩略图、多种手势、CocoaPods）

支持哪些布局

流水布局 、 线性布局

支持哪些手势

单击 、双击 、捏合 、旋转、拖拽、侧滑

什么地方用到这个框架

主要用于社交app,用于呈现一组图片
以下是各个流行社交app的部分截图

高仿QQ、微信效果的图片浏览器（支持原图和缩略图、多种手势、CocoaPods）

依赖哪些第三方框架

图片浏览依赖框架

MBProgressHUD
SDWebImage
DACircularProgress

PYPhotoBrowser框架的主要类

PYPhotosView（快速使用）

@interface PYPhotosView : UIScrollView

/** 代理 */

@property (nonatomic, weak) id<PYPhotosViewDelegate> delegate;

/** 网络图片模型数组 */

@property (nonatomic, copy) NSArray *photos;

@property (nonatomic, copy) NSArray *thumbnailUrls;

@property (nonatomic, copy) NSArray *originalUrls;

/** 本地相册图片数组(默认最多为九张,当传入图片数组长度超过九张时，取前九张) */

@property (nonatomic, strong) NSMutableArray *images;

/** 所有图片的状态（默认为已发布状态） */

@property (nonatomic, assign) PYPhotosViewState photosState;

/** 图片布局（默认为流水布局） */

@property (nonatomic, assign) PYPhotosViewLayoutType layoutType;

/** 图片分页指示类型(默认为pageControll。当图片超过九张，改为label显示) */

@property (nonatomic, assign) PYPhotosViewPageType pageType;

/** 图片间距（默认为5） */

@property (nonatomic, assign) CGFloat photoMargin;

/** 图片的宽 (默认为70) */

@property (nonatomic, assign) CGFloat photoWidth;

/** 图片的高 (默认为70) */

@property (nonatomic, assign) CGFloat photoHeight;

/** 每行最多个数（默认为3）, 当图片布局为线性布局时，此设置失效 */

@property (nonatomic, assign) NSInteger photosMaxCol;

/** 当图片上传前，最多上传的张数，默认为9 */

@property (nonatomic, assign) NSInteger imagesMaxCountWhenWillCompose;

/** 快速创建photosView对象 */

+ (instancetype)photosView;

/** photos : 保存图片链接的数组 */

+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls originalUrls:(NSArray *)originalUrls;

/** images : 存储本地图片的数组 */

+ (instancetype)photosViewWithImages:(NSMutableArray *)images;

/**

* thumbnailUrls : 保存图片(缩略图)链接的数组

* originalUrls : 保存图片(原图)链接的数组

* type : 布局类型（默认为流水布局）

+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls originalUrls:(NSArray *)originalUrls layoutType:(PYPhotosViewLayoutType)type;

/**

* thumbnailUrls : 保存图片(缩略图)链接的数组

* originalUrls : 保存图片(原图)链接的数组

* maxCol : 每行最多显示图片的个数

+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls originalUrls:(NSArray *)originalUrls photosMaxCol:(NSInteger)maxCol;

/** 根据图片个数和图片状态自动计算出PYPhontosView的size */

- (CGSize)sizeWithPhotoCount:(NSInteger)count photosState:(NSInteger)state;

/**

* 刷新图片(未发布)

* images : 新的图片数组

- (void)reloadDataWithImages:(NSMutableArray *)images;

@end

PYPhotoBrowseView（自定义）

@protocol PYPhotoBrowseViewDelegate <NSObject>

@optional

/**

* 图片浏览将要显示时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView willShowWithImages:(NSArray *)images index:(NSInteger)index;

/**

* 图片浏览已经显示时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView didShowWithImages:(NSArray *)images index:(NSInteger)index;

/**

* 图片浏览将要隐藏时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView willHiddenWithImages:(NSArray *)images index:(NSInteger)index;

/**

* 图片浏览已经隐藏时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView didHiddenWithImages:(NSArray *)images index:(NSInteger)index;

/**

* 图片单击时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView didSingleClickedImage:(UIImage *)image index:(NSInteger)index;

/**

* 图片长按时调用

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView didLongPressImage:(UIImage *)image index:(NSInteger)index;

@end

@protocol PYPhotoBrowseViewDataSource <NSObject>

@required

/** 返回将要浏览的图片（UIImage）数组 */

- (NSArray *)imagesForBrowse;

@optional

/** 返回默认显示图片的索引(默认为0) */

- (NSInteger)currentIndex;

/** 默认显示图片相对于主窗口的位置 */

- (CGRect)frameFormWindow;

/** 消失回到相对于住窗口的指定位置 */

- (CGRect)frameToWindow;

@end

@interface PYPhotoBrowseView : UIWindow <PYPhotoViewDelegate>

/** 代理 */

@property (nonatomic, weak) id<PYPhotoBrowseViewDelegate> delegate;

/** 数据源代理 */

@property (nonatomic, weak) id<PYPhotoBrowseViewDataSource> dataSource;

/** 用来浏览的图片（UIImage）数组 */

@property (nonatomic, copy) NSArray *images;

/** 用来记录当前下标 */

@property (nonatomic, assign) NSInteger currentIndex;

/**

* 浏览图片

- (void)show;

/**

* 隐藏

- (void)hidden;

@end

如何使用PYPhotoBrowser

使用Cocoapods:

pod "PYPhotoBrowser"
导入主头文件#import <PYPhotoBrowser.h>

手动导入：

将PYPhotoBrowser文件夹中的所有文件拽入项目中
导入主头文件#import "PYPhotoBrowser.h"
使用注意:如果项目本来就有依赖的第三方框架：MBProgressHUD、SDWebImage、DACircularProgress就不必重复导入, 如果没有，选择Dependency文件夹中，项目不存在的框架拽入项目。

具体使用（详情见示例程序PYPhotosViewExample）

已发布（网络图片浏览）
示例代码：

// 1. 创建缩略图图片链接数组

NSMutableArray *thumbnailImageUrls = [NSMutableArray array];

// 添加图片(缩略图)链接

[thumbnailImageUrls addObject:@"http://ww3.sinaimg.cn/thumbnail/006ka0Iygw1f6bqm7zukpj30g60kzdi2.jpg"];

[thumbnailImageUrls addObject:@"http://ww1.sinaimg.cn/thumbnail/61b69811gw1f6bqb1bfd2j20b4095dfy.jpg"];

[thumbnailImageUrls addObject:@"http://ww1.sinaimg.cn/thumbnail/54477ddfgw1f6bqkbanqoj20ku0rsn4d.jpg"];

[thumbnailImageUrls addObject:@"http://ww4.sinaimg.cn/thumbnail/006ka0Iygw1f6b8gpwr2tj30bc0bqmyz.jpg"];

[thumbnailImageUrls addObject:@"http://ww2.sinaimg.cn/thumbnail/9c2b5f31jw1f6bqtinmpyj20dw0ae76e.jpg"];

[thumbnailImageUrls addObject:@"http://ww1.sinaimg.cn/thumbnail/536e7093jw1f6bqdj3lpjj20va134ana.jpg"];

[thumbnailImageUrls addObject:@"http://ww1.sinaimg.cn/thumbnail/75b1a75fjw1f6bqn35ij6j20ck0g8jtf.jpg"];

[thumbnailImageUrls addObject:@"http://ww2.sinaimg.cn/thumbnail/005NFHyQgw1f6bn8bha0eg308w0gib2d.gif"];

[thumbnailImageUrls addObject:@"http://ww1.sinaimg.cn/thumbnail/86afb21egw1f6bq3lq0itj20gg0c2myt.jpg"];

// 1.2 创建原图图片链接数组

NSMutableArray *originalImageUrls = [NSMutableArray array];

// 添加图片(原图)链接

[originalImageUrls addObject:@"http://ww3.sinaimg.cn/large/006ka0Iygw1f6bqm7zukpj30g60kzdi2.jpg"];

[originalImageUrls addObject:@"http://ww1.sinaimg.cn/large/61b69811gw1f6bqb1bfd2j20b4095dfy.jpg"];

[originalImageUrls addObject:@"http://ww1.sinaimg.cn/large/54477ddfgw1f6bqkbanqoj20ku0rsn4d.jpg"];

[originalImageUrls addObject:@"http://ww4.sinaimg.cn/large/006ka0Iygw1f6b8gpwr2tj30bc0bqmyz.jpg"];

[originalImageUrls addObject:@"http://ww2.sinaimg.cn/large/9c2b5f31jw1f6bqtinmpyj20dw0ae76e.jpg"];

[originalImageUrls addObject:@"http://ww1.sinaimg.cn/large/536e7093jw1f6bqdj3lpjj20va134ana.jpg"];

[originalImageUrls addObject:@"http://ww1.sinaimg.cn/large/75b1a75fjw1f6bqn35ij6j20ck0g8jtf.jpg"];

[originalImageUrls addObject:@"http://ww2.sinaimg.cn/large/005NFHyQgw1f6bn8bha0eg308w0gib2d.gif"];

[originalImageUrls addObject:@"http://ww1.sinaimg.cn/large/86afb21egw1f6bq3lq0itj20gg0c2myt.jpg"];

// 2. 创建一个photosView

PYPhotosView *photosView = [PYPhotosView photosViewWithThumbnailUrls:thumbnailImageUrls originalUrls:originalImageUrls];

// 3. 添加photosView

[self.view addSubview:photosView];

未发布（本地图片上传\发布\预览）
示例代码：

// 1. 创建本地图片数组

NSMutableArray *imagesM = [NSMutableArray array];

for (int i = 0; i < arc4random_uniform(4) + 1; i++) {

[imagesM addObject:[UIImage imageNamed:[NSString stringWithFormat:@"%02d", i + 1]]];

}

// 2.1 设置本地图片

PYPhotosView *photosView = [PYPhotosView photosViewWithImages:imagesM];

// 3. 设置代理

photosView.delegate = self;

// 4. 添加photosView

[self.view addSubview:photosView];

自定义图片浏览（使用PYPhotoBrowseView类）

// 1.创建自己定义的browseView

PYPhotoBrowseView *browseView = [[PYPhotoBrowseView alloc] init];

// 2.设置数据源和代理并实现数据源和代理方法

browseView.dataSource = self;

browseView.delegate = self;

// 3.显示（浏览）

[browseView show];

// 实现数据源方法

#pragma mark - PYPhotoBrowseViewDataSource

// 返回将要浏览的图片(UIImage)数组

- (NSArray *)imagesForBrowse

{

NSMutableArray *imagesM = [NSMutableArray array];

for (int i = 0; i < 6 + 1; i++) {

[imagesM addObject:[UIImage imageNamed:[NSString stringWithFormat:@"%02d", i + 1]]];

}

return imagesM;

}

// 返回默认显示图片的下标(默认为0)

- (NSInteger)currentIndex

{

return 2;

}

// 返回从窗口的哪个位置开始显示（注意：frame是相当于window）

- (CGRect)frameFormWindow

{

return CGRectZero;

}

// 返回消失到窗口的哪个位置（注意：frame是相当于window）

- (CGRect)frameToWindow

{

return CGRectMake(100, 300, 200, 200);

}

// 实现代理方法

#pragma mark PYPhotoBrowseViewDelegate

- (void)photoBrowseView:(PYPhotoBrowseView *)photoBrowseView didSingleClickedImage:(UIImage *)image index:(NSInteger)index

{

NSLog(@"图片单击时调用");

// 关闭浏览

[photoBrowseView hidden];

}

自定义photosView

通过设置photosView的对象属性值即可修改

设置布局类型（默认为流水布局）

// 设置布局为线性布局

photosView.layoutType = PYPhotosViewLayoutTypeLine;

设置分页指示类型（默认为pageControll指示器）

// 设置指示类型为文本指示

photosView.pageType = PYPhotosViewPageTypeLabel;

设置图片间距（默认为5）

// 设置图片间距为10

photosView.photoMargin = 10;

设置图片大小（默认70*70）

// 设置图片的宽（width）

photosView.photoWidth = 100;

// 设置图片的高（height）

photosView.photoHeight = 60;

设置每行图片最多个数（默认为3个）

// 设置图片最多列数

photosView.photosMaxCol = 6;

设置图片上传前，最多上传的张数（默认为9）

// 设置图片最多上传的张数

photosView.imagesMaxCountWhenWillCompose = 15;

期待

如果您在使用过程中有任何问题，欢迎直接加我QQ:499491531联系，很乐意为您解答任何相关问题!
与其给我点star，不如向我狠狠地抛来一个BUG！
如果感兴趣的小伙伴想要参与这个项目的维护，可以随时联系我或者直接pull request！
如果您想要更多的接口来自定义，欢迎issue me！我会根据大家的需求提供更多的接口！

2088位程序猿阅读分享

高仿QQ、微信效果的图片浏览器（支持原图和缩略图、多种手势、CocoaPods）

有意思啊

还要错过关注我?

长按二维码

关注的不仅仅是技术

以上是关于高仿QQ微信效果的图片浏览器（支持原图和缩略图多种手势CocoaPods）的主要内容，如果未能解决你的问题，请参考以下文章

实现图片加载从模糊到清晰显示的方法

Android 中实现选择图片生成缩略图点击查看大图的功能

Android 高仿微信发朋友圈浏览图片效果

Android高仿微信图片选择上传工具

怎样更换网站主题图片

一款实用的viewer.js 图片相册

高仿QQ微信效果的图片浏览器（支持原图和缩略图多种手势CocoaPods）

原文链接: https://github.com/iphone5solo/PYPhotoBrowser 原文作者 : CoderKo1o

Contents

效果图

支持哪些状态

支持哪些布局

支持哪些手势

什么地方用到这个框架

依赖哪些第三方框架

PYPhotoBrowser框架的主要类

PYPhotosView（快速使用）

PYPhotoBrowseView（自定义）

如何使用PYPhotoBrowser

具体使用（详情见示例程序PYPhotosViewExample）

自定义photosView

通过设置photosView的对象属性值即可修改

期待

原文链接:
https://github.com/iphone5solo/PYPhotoBrowser

原文作者 : CoderKo1o