PYPhotoBrowser 是一個用法簡單的圖片瀏覽框架,能輕鬆呈現一組圖片,支援原圖與縮略圖、多種手勢,並可透過 CocoaPods 安裝。
圖片已發布(網絡圖片瀏覽、流水佈局)

圖片未發布(本地圖片上傳/發布/預覽)

已發布(網絡圖片瀏覽)

未發布(本地圖片上傳/發布/預覽)

流水佈局、線性佈局。
單擊、雙擊、捏合、旋轉、拖拽、側滑。
主要用於社交類 App,用來呈現一組圖片。以下是幾個主流社交應用的部分截圖:




圖片瀏覽部分依賴:
@interface PYPhotosView : UIScrollView
/** 代理 */
@property (nonatomic, weak) id 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;
/** thumbnailUrls:縮略圖鏈接數組;originalUrls:原圖鏈接數組 */
+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls
originalUrls:(NSArray *)originalUrls;
/** images:本地圖片數組 */
+ (instancetype)photosViewWithImages:(NSMutableArray *)images;
/** 可指定佈局類型(預設流水佈局) */
+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls
originalUrls:(NSArray *)originalUrls
layoutType:(PYPhotosViewLayoutType)type;
/** 可指定每行最多顯示張數 */
+ (instancetype)photosViewWithThumbnailUrls:(NSArray *)thumbnailUrls
originalUrls:(NSArray *)originalUrls
photosMaxCol:(NSInteger)maxCol;
/** 依圖片數量與狀態自動計算 PYPhotosView 的 size */
- (CGSize)sizeWithPhotoCount:(NSInteger)count photosState:(NSInteger)state;
/** 刷新未發布的圖片 */
- (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; /** 用來瀏覽的圖片鏈接(NSString)數組 */ @property (nonatomic, copy) NSArray *imagesURL; /** 用來瀏覽的圖片控件(UIImageView)數組 */ @property (nonatomic, copy) NSArray *sourceImgageViews; /** 當前下標 */ @property (nonatomic, assign) NSInteger currentIndex; /** 瀏覽圖片 */ - (void)show; /** 隱藏 */ - (void)hidden; @end
CocoaPods:
pod "PYPhotoBrowser"
然後導入主頭檔:
#import "PYPhotoBrowser.h"

手動導入:
#import "PYPhotoBrowser.h"。// 1. 創建縮略圖鏈接數組
NSMutableArray *thumbnailImageUrls = [NSMutableArray array];
[thumbnailImageUrls addObject:@"https://ww3.sinaimg.cn/thumbnail/006ka0Iygw1f6bqm7zukpj30g60kzdi2.jpg"];
[thumbnailImageUrls addObject:@"https://ww1.sinaimg.cn/thumbnail/61b69811gw1f6bqb1bfd2j20b4095dfy.jpg"];
[thumbnailImageUrls addObject:@"https://ww1.sinaimg.cn/thumbnail/54477ddfgw1f6bqkbanqoj20ku0rsn4d.jpg"];
[thumbnailImageUrls addObject:@"https://ww4.sinaimg.cn/thumbnail/006ka0Iygw1f6b8gpwr2tj30bc0bqmyz.jpg"];
// 1.2 創建原圖鏈接數組
NSMutableArray *originalImageUrls = [NSMutableArray array];
[originalImageUrls addObject:@"https://ww3.sinaimg.cn/large/006ka0Iygw1f6bqm7zukpj30g60kzdi2.jpg"];
[originalImageUrls addObject:@"https://ww1.sinaimg.cn/large/61b69811gw1f6bqb1bfd2j20b4095dfy.jpg"];
[originalImageUrls addObject:@"https://ww1.sinaimg.cn/large/54477ddfgw1f6bqkbanqoj20ku0rsn4d.jpg"];
[originalImageUrls addObject:@"https://ww4.sinaimg.cn/large/006ka0Iygw1f6b8gpwr2tj30bc0bqmyz.jpg"];
// 2. 創建 photosView
PYPhotosView *photosView = [PYPhotosView photosViewWithThumbnailUrls:thumbnailImageUrls
originalUrls:originalImageUrls];
// 3. 添加到視圖
[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:@"d", i + 1]]];
}
// 2. 設置本地圖片
PYPhotosView *photosView = [PYPhotosView photosViewWithImages:imagesM];
// 3. 設置代理
photosView.delegate = self;
// 4. 添加 photosView
[self.view addSubview:photosView];// 1. 創建 photoBroseView 對象 PYPhotoBrowseView *photoBroseView = [[PYPhotoBrowseView alloc] init]; // 2.1 設置圖片源(UIImageView)數組 photoBroseView.sourceImgageViews = imageViews; // 2.2 設置初始圖片下標 photoBroseView.currentIndex = 2; // 3. 顯示 [photoBroseView show];
直接改 photosView 的屬性即可。
佈局方式(預設流水佈局):
photosView.layoutType = PYPhotosViewLayoutTypeLine;
分頁指示類型(預設 pageControll):
photosView.pageType = PYPhotosViewPageTypeLabel;
圖片間距(預設 5):
photosView.photoMargin = 10;
圖片尺寸(預設 70×70):
photosView.photoWidth = 100; photosView.photoHeight = 60;
每行最多張數(預設 3):
photosView.photosMaxCol = 6;
上傳前最多張數(預設 9):
photosView.imagesMaxCountWhenWillCompose = 15;
使用中遇到任何問題,歡迎直接聯絡作者(QQ:499491531),很樂意為你解答。
與其給專案點 star,不如狠狠丟一個 bug 過來。想參與維護的朋友,隨時歡迎 pull request;如果你需要更多自定義接口,也歡迎提 issue,我會依需求補上。若你在上線的 App 中使用了這個框架,也請告訴我,方便我統計與更新。