Getting Started
框架使用
期待
流水布局
、 线性布局
单击
、 双击
、 捏合
、 旋转
、 拖拽
、 侧滑
MBProgressHUD
SDWebImage
@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
@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
pod "PYPhotosView"
#import <PYPhotosView.h>
PYPhotosView
文件夹中的所有文件拽入项目中 #import "PYPhotosView.h"
使用注意:
如果项目本来就有依赖的第三方框架: MBProgressHUD、SDWebImage
就不必重复导入, 如果没有,选择 Dependency
文件夹中,项目不存在的框架拽入项目。 示例代码:
// 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];
示例代码:
// 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.layoutType = PYPhotosViewLayoutTypeLine;
// 设置指示类型为文本指示
photosView.pageType = PYPhotosViewPageTypeLabel;
// 设置图片间距为10 photosView.photoMargin = 10;
// 设置图片的宽(width) photosView.photoWidth = 100; // 设置图片的高(height) photosView.photoHeight = 60;
// 设置图片最多列数 photosView.photosMaxCol = 6;
// 设置图片最多上传的张数 photosView.imagesMaxCountWhenWillCompose = 15;