AFTPhotoScroller是一个简单且灵活的照片浏览组件，其实现了iOS照片app的基本功能。
其开发的灵感来自于苹果WWDC2010年的视频Designing Apps with Scroll Views。该视频主要讲解了通过UIScrollView的嵌套技巧来实现照片浏览的功能。有很多很棒的开源库都对此作了封装，使得自己的照片浏览框架使用起来更加的容易，但AFTPhotoScroller所做的事情却有所不同。
就像经典的照片浏览框架一样，AFTPhotoScroller能够实现用户左右翻页图片和对单个图片的放大缩小，不仅如此，它的特性还包含其他方面：
不像UIPageViewController，在AFTPhotoScroller提供的接口中没有controller，而直接是采用一个叫AFTPagingScrollView翻页视图来做照片浏览，这样的话，开发者就可以自己个性化订制自己的controller，这就好比直接使用UITableView而非UITableViewController的好处一样。它同样实现了UIPageViewController自带的页面重用机制、页面间的间距计算、以及做最少量的缓存管理等等，但是不能够实现真实的纸张翻页效果(page curl)和书脊位置(spine location)。
允许开发者订制的细节如下：
- 页面之间的间距
- 开启或禁用双击放大或缩小图片的手势
- 给双击手势设置图片放大的尺度，即双击后图片放大效果与最大效果的比例
- 支持垂直方向的翻页
- 支持视差效果 (体验类似iOS 10的照片app，如需简单了解什么是“视差滑动(Parallax Scrolling)”，可以参考这篇博客)
允许开发者订制的交互回调如下：
- 是否允许展示某个页面
- 可以直接跳转至某个页面
- 可以重载单个页面 (用于配合网络获取图片后的刷新)
- 获取翻页、缩放手势和双击手势的初始状态
- 获取页面即将完全展示的回调 (即一个页面占据大于屏幕一半位置的时候)
相比官方或其他的照片翻页库，在什么情况下选择AFTPhotoScroller会更有优势呢？
- 有视差效果的需求（该框架允许通过设置paddingBetweenPages属性来实现对视差明显程度的控制）
- 有特殊业务需求，导致使用官方的
UIPageViewController或者其他带有controller的开源库比较不容易做深度修改，比如像demo中使用自己写的导航栏、在底部添加自己写的页码条、或者需要网络获取图片等等；AFTPhotoScroller能够在很大程度上满足开发者根据自己的需求订制图片翻页，因此该框架本身没有包含controller，只有一个AFTPagingScrollView可供使用，理念是留给开发者根据需要来构建自己想要的controller - 使用
AFTPagingScrollView和使用UITableView的感觉，基本是一样的，因此容易上手。
首先安装AFTPhotoScroller；
接着#import <AFTPhotoScroller/AFTPhotoScroller.h>；
在UIViewController子类中，只需要简单的加入以下代码即可：
- (void)viewDidLoad {
[super viewDidLoad];
self.automaticallyAdjustsScrollViewInsets = NO;
self.pagingView = [[AFTPagingScrollView alloc] initWithFrame:self.view.bounds];
self.pagingView.dataSource = self;
self.pagingView.paddingBetweenPages = 6;
[self.view addSubview:self.pagingView];
self.images = ... // load images
[self.pagingView reloadData]; // build UI and load required data
}
#pragma mark - AFTPagingScrollViewDataSource
- (NSInteger)numberOfPagesInPagingScrollView:(AFTPagingScrollView *)pagingScrollView {
return self.images.count;
}
- (UIImage *)pagingScrollView:(AFTPagingScrollView *)pagingScrollView imageForPageAtIndex:(NSInteger)pageIndex {
return self.images[pageIndex];
}
首先安装AFTPhotoScroller (必须在Podfile中写明use_frameworks!)
接着import AFTPhotoScroller
在UIViewController子类中，只需要简单的加入以下代码即可：
import UIKit
import AFTPhotoScroller
class ViewController: UIViewController, AFTPagingScrollViewDataSource {
var pagingView: AFTPagingScrollView!
var images: [UIImage]!
override func viewDidLoad() {
super.viewDidLoad()
pagingView = AFTPagingScrollView(frame:view.bounds)
pagingView.isParallaxScrollingEnabled = true
pagingView.dataSource = self
view.addSubview(pagingView)
images = loadAllImages()
pagingView.reloadData()
}
public func numberOfPages(in pagingScrollView: AFTPagingScrollView) -> Int {
return images.count
}
public func pagingScrollView(_ pagingScrollView: AFTPagingScrollView, imageForPageAt pageIndex: Int) -> UIImage {
return images[pageIndex]
}
func loadAllImages() -> [UIImage] {
....
}
}
建议下载github demo，这个demo展示了创建几种不同类型的照片浏览，并且附赠了底部页码条和导航栏的push动画。
当然真正的app中，我们不建议像demo一样一次性加载所有图片到内存中去。
iOS 6+
AFTPhotoScroller可以通过CocoaPods进行安装。只需要在你的Podfile中加入即可。
pod "AFTPhotoScroller"- WWDC的demo PhotoScroller(ARC版)
- Demo中的本地图片摘自MJParallaxCollectionView，源于unsplash
- Demo中的网络图片摘自YYKit，源于dribbble
huangkun, jack-huang-developer@foxmail.com
AFTPhotoScroller使用MIT许可，相关内容请查看LICENSE文件。