您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

PYPhotoBrowser:高仿 QQ、微信的圖片瀏覽器

編輯:iOS 開發基礎

PYPhotoBrowser 是一個用法簡單的圖片瀏覽框架,能輕鬆呈現一組圖片,支援原圖與縮略圖、多種手勢,並可透過 CocoaPods 安裝。

效果預覽

圖片已發布(網絡圖片瀏覽、流水佈局)

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

目前的使用者

  • 香脈
  • 汕醫移動辦公

支援的狀態

已發布(網絡圖片瀏覽)

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

支援的佈局

流水佈局、線性佈局。

支援的手勢

單擊、雙擊、捏合、旋轉、拖拽、側滑。

適用場景

主要用於社交類 App,用來呈現一組圖片。以下是幾個主流社交應用的部分截圖:

依賴的第三方庫

圖片瀏覽部分依賴:

  • MBProgressHUD
  • SDWebImage
  • DACircularProgress

核心類別

PYPhotosView(快速使用)

@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

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;
/** 用來瀏覽的圖片鏈接(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"

手動導入:

  • 把 PYPhotoBrowser 資料夾中的所有檔案拖進專案。
  • 導入主頭檔 #import "PYPhotoBrowser.h"。
  • 若專案已包含 MBProgressHUD、SDWebImage、DACircularProgress,就不必重複導入;缺少哪個,就從 Dependency 資料夾中挑出來放進專案。

使用範例

已發布(網絡圖片瀏覽)

// 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];

只用瀏覽功能(PYPhotoBrowseView)

// 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 中使用了這個框架,也請告訴我,方便我統計與更新。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved