SGPhotoBrowser 是一個輕量、易用的 iOS 照片瀏覽框架。它支援縮圖預覽、原圖瀏覽、手勢縮放、批量刪除與網路圖片下載,適合需要快速整合相簿體驗的專案。

使用者可以先在縮圖頁面瀏覽照片,點擊後進入原圖模式。原圖頁面支援單擊隱藏工具列、雙擊切換縮放、捏合手勢與左右滑動切換。工具列也可進入編輯模式,批次匯出或刪除。


框架使用 block 作為資料源,讓呼叫端可以提供照片數量、指定位置的模型、重新載入與刪除回呼。每張照片以 SGPhotoModel 表示,其中包含原圖與縮圖的 URL。若 URL 不是 file URL,就會走非同步下載與快取流程。
原圖解析度高,若全部載入會佔用大量記憶體。因此框架只保留目前與相鄰位置的原圖,其他位置先顯示縮圖。當使用者滾動到新位置時,再載入該處與相鄰原圖,並把遠處原圖換回縮圖。
為了避免滾動卡頓,原圖載入會等到 scrollViewDidEndDecelerating 之後才執行。也就是說,滑動過程中先維持輕量顯示,停止後再載入高解析度內容。
框架為 UIImageView 建立分類,透過 sg_setImageWithURL:model: 判斷圖片來源。若是網路圖片,會先檢查快取;若尚未下載,則顯示 MBProgressHUD 進度提示。下載完成後,圖片會被快取,下次即可直接讀取。
每張原圖都被包在 scrollView 中,方便處理縮放。單擊與雙擊透過 touchesEnded 判斷,並將單擊延遲一小段時間,以避免與雙擊衝突。批量模式則利用模型的 isSelected 屬性記錄狀態,再由工具列統一處理匯出與刪除。