关于** UIPageViewController**, 在之前做翻书效果的时候使用过一次(iOS UIPageViewController - 使用总结), 之后就再没怎么接触, 后来发现这个类值得学习的地方, 还是很多的, 在这里再重新学习一下这个类.

打开底层的API, 会发现其接口十分简单, 主要是其代理方法和一个初始化方法, 其他的很多属性都是只读的 , 但并不是就不需要设置, 这些都放在了其初始化方法里了.

初始化

系统提供的初始化方法主要是下面这个:

- (instancetype)initWithTransitionStyle:(UIPageViewControllerTransitionStyle)style navigationOrientation:(UIPageViewControllerNavigationOrientation)navigationOrientation options:(nullable NSDictionary<NSString *, id> *)options

简单介绍下这里的几个参数:

• style : 控制器的类型, 枚举, 有以下两种

typedef NS_ENUM(NSInteger, UIPageViewControllerTransitionStyle) {
// 上下翻页, 类似翻书
    UIPageViewControllerTransitionStylePageCurl = 0, // Navigate between views via a page curl transition.
// 左右滑动 
    UIPageViewControllerTransitionStyleScroll = 1 // Navigate between views by scrolling. 
};

• navigationOrientation : 导航方向, 枚举

typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationOrientation) {
// 水平方向(左右滑动或翻页)
    UIPageViewControllerNavigationOrientationHorizontal = 0,
// 竖直方向(上下滑动或翻页)
    UIPageViewControllerNavigationOrientationVertical = 1
};

• options: 其他配置, 是一个字典, 包含两个key
• **UIPageViewControllerOptionSpineLocationKey : **

仅在style为UIPageViewControllerTransitionStylePageCurl时有效;
对应的值为NSNumber对象, 包含的数值也是一个枚举:
typedef NS_ENUM(NSInteger, UIPageViewControllerSpineLocation) {
    UIPageViewControllerSpineLocationNone = 0, // Returned if 'spineLocation' is queried when 'transitionStyle' is not 'UIPageViewControllerTransitionStylePageCurl'.
// 单页显示, 从上往下翻页
    UIPageViewControllerSpineLocationMin = 1,  // Requires one view controller.
// 双页显示
    UIPageViewControllerSpineLocationMid = 2,  // Requires two view controllers.
// 单页显示, 从下往上翻
    UIPageViewControllerSpineLocationMax = 3   // Requires one view controller.
};   // Only pertains to 'UIPageViewControllerTransitionStylePageCurl'.

使用举例: 设置为双页显示

NSDictionary * options = [NSDictionary dictionaryWithObject:[NSNumber numberWithInteger:UIPageViewControllerSpineLocationMid] forKey:UIPageViewControllerOptionSpineLocationKey];

• UIPageViewControllerOptionInterPageSpacingKey :
  仅在style为UIPageViewControllerTransitionStyleScroll时有效;
  对应的值为NSNumber对象, 包含的数值为CGFloat类型, 用于设置页边距, 即: 两个控制器的view之间的间隔
  使用举例: 设置页面间距为10

NSDictionary *option = [NSDictionary dictionaryWithObject:[NSNumber numberWithInteger:10.0] forKey:UIPageViewControllerOptionInterPageSpacingKey];

属性

这里仅介绍可设置的属性, 大部分的属性都是只读的

• delegate 代理协议
• dataSource 数据源协议
• doubleSided 是否双面显示, 当UIPageViewControllerSpineLocationMid时, 默认为YES, 其他情况默认为NO

实例方法

这个方法主要是设置某个控制器可视化, 也就是显示某个控制器

- (void)setViewControllers:(nullable NSArray<UIViewController *> *)viewControllers direction:(UIPageViewControllerNavigationDirection)direction animated:(BOOL)animated completion:(void (^ __nullable)(BOOL finished))completion

参数:

• viewControllers: 待显示的控制器

• direction: 切换方向, 是一个枚举

typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationDirection) {
// 正向切换
    UIPageViewControllerNavigationDirectionForward,
// 反向切换
    UIPageViewControllerNavigationDirectionReverse
};

• animated : 是否带有动画
• completion: 切换完成后的回调

以上便是UIPageViewController的初始化, 一些可配置属性以及实例方法, 下面就是其代理方法和数据源方法了;

UIPageViewControllerDataSource 数据源方法

主要使用到的, 而且是必须实现的数据源方法是以下两个, 用于返回下一个控制器

// 返回当前控制器的前一个控制器
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController;
// 返回当前控制器的后一个控制器
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController;

还有两个可选实现的数据源方法:

- (NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController NS_AVAILABLE_IOS(6_0); // The number of items reflected in the page indicator.
- (NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController 

这两个方法使用, 可以参考这个回答stackoverflow

UIPageViewControllerDelegate 代理方法

// 手势滑动(或翻页)开始时回调
- (void)pageViewController:(UIPageViewController *)pageViewController willTransitionToViewControllers:(NSArray<UIViewController *> *)pendingViewControllers 
// 滑动结束时的回调
- (void)pageViewController:(UIPageViewController *)pageViewController didFinishAnimating:(BOOL)finished previousViewControllers:(NSArray<UIViewController *> *)previousViewControllers transitionCompleted:(BOOL)completed

上面第二个方法的参数中的两个BOOL值简单说明一下:

• finished : 滑动(或者翻页)动画是否完成

• completed: 是否切换成功

在我们进行滑动(或翻页)的时候, 如果滑动(或翻页)的幅度不够, 控制器会恢复至原有的控制器状态, 不会切换到下一个, 这两个BOOL值就是用来标识动画的状态, 和是否切换成功的状态;

// 根据orientation切换UIPageViewControllerSpineLocation
- (UIPageViewControllerSpineLocation)pageViewController:(UIPageViewController *)pageViewController spineLocationForInterfaceOrientation:(UIInterfaceOrientation)orientation __TVOS_PROHIBITED;
// 返回支持的方法
- (UIInterfaceOrientationMask)pageViewControllerSupportedInterfaceOrientations:(UIPageViewController *)pageViewController NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
// 优先使用的方向
- (UIInterfaceOrientation)pageViewControllerPreferredInterfaceOrientationForPresentation:(UIPageViewController *)pageViewController 

下一篇文章, [iOS]UIPageViewController使用--实战

(完)