一、前言
UIPageViewController 是 iOS 中少見的動畫視圖控制器之一。透過它,既可以建立類似 UIScrollView 與 UIPageControl 結合的滾屏視圖,也可以建立類似圖書效果的炫酷翻頁視圖。
UIPageViewController 在 iOS 5 SDK 中首次引入,讓開發者可以用它建立分頁視圖。到了 iOS 6,這個類有了更新,支援滾動過渡效果。使用 Page View,使用者可以方便地透過手勢在多個頁面之間導航。它不僅可用於引導頁,許多遊戲(例如憤怒的小鳥)就是用它來展示關卡選擇頁面,也有書籍類應用用它來顯示書頁。
UIPageViewController 是一個高度可配置的類,你可以進行如下配置:
UIPageViewController 類似一個視圖容器,其中每個具體的視圖由各自的 ViewController 維護管理,UIPageViewController 只負責協調與動畫布置。下圖很好地展現了 UIPageViewController 的使用結構:

上圖中,UIPageViewControllerDataSource 協議為 UIPageViewController 提供資料支援,DataSource 協議提供的資料來自各個 ViewController 自行維護;UIPageViewControllerDelegate 中的回調可以對翻頁動作、螢幕旋轉動作等進行監聽。UIPageViewController 把從 DataSource 中取得的視圖資料渲染給 View,用於當前視圖控制器的展示。
為了示範,我們會一起建立一個簡單的 App。我們不會演示所有 UIPageViewController 的配置細節,而是示範使用滑動翻頁樣式建立一個引導頁。有了對 UIPageViewController 的基本理解,相信你能夠去探索其他的特性。
二、建立一個 UIPageViewController
首先新建一個類作為翻頁視圖控制器中每一頁具體視圖的控制器,使其繼承自 UIViewController:
ModelViewController.h
#import <UIKit/UIKit.h>
@interface ModelViewController : UIViewController
+(ModelViewController *)creatWithIndex:(int)index;
@property(nonatomic,strong)UILabel * indexLabel;
@endModelViewController.m
#import "ModelViewController.h"
@interface ModelViewController ()
@end
@implementation ModelViewController
+(ModelViewController *)creatWithIndex:(int)index{
ModelViewController * con = [[ModelViewController alloc]init];
con.indexLabel = [[UILabel alloc]initWithFrame:CGRectMake(110, 200, 100, 30)];
con.indexLabel.text = [NSString stringWithFormat:@"第%d頁",index];
[con.view addSubview:con.indexLabel];
return con;
}
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor redColor];
}
@end在工程模板自帶的 ViewController.m 檔案中實作如下程式碼:
#import "ViewController.h"
#import "ModelViewController.h"
//遵守協議
@interface ViewController ()<UIPageViewControllerDataSource,UIPageViewControllerDelegate>
{
//翻頁視圖控制器物件
UIPageViewController * _pageViewControl;
//資料來源陣列
NSMutableArray * _dataArray;
}
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
//進行初始化
_pageViewControl = [[UIPageViewController alloc]initWithTransitionStyle:UIPageViewControllerTransitionStyleScroll navigationOrientation:UIPageViewControllerNavigationOrientationHorizontal options:@{UIPageViewControllerOptionSpineLocationKey:@0,UIPageViewControllerOptionInterPageSpacingKey:@10}];
self.view.backgroundColor = [UIColor greenColor];
//設定翻頁視圖的尺寸
_pageViewControl.view.bounds=self.view.bounds;
//設定資料來源與代理
_pageViewControl.dataSource=self;
_pageViewControl.delegate=self;
//建立初始界面
ModelViewController * model = [ModelViewController creatWithIndex:1];
//設定初始界面
[_pageViewControl setViewControllers:@[model] direction:UIPageViewControllerNavigationDirectionReverse animated:YES completion:nil];
//設定是否雙面展示
_pageViewControl.doubleSided = NO;
_dataArray = [[NSMutableArray alloc]init];
[_dataArray addObject:model];
[self.view addSubview:_pageViewControl.view];
}
//向前翻頁,這個資料來源方法回傳的視圖控制器為要顯示視圖的視圖控制器
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController{
int index = (int)[_dataArray indexOfObject:viewController];
if (index==0) {
return nil;
}else{
return _dataArray[index-1];
}
}
//向後翻頁,這個資料來源方法回傳的視圖控制器為要顯示視圖的視圖控制器
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController{
int index = (int)[_dataArray indexOfObject:viewController];
if (index==9) {
return nil;
}else{
if (_dataArray.count-1>=(index+1)) {
return _dataArray[index+1];
}else{
ModelViewController * model = [ModelViewController creatWithIndex:index+2];
[_dataArray addObject:model];
return model;
}
}
}
//螢幕旋轉觸發的代理方法
- (UIPageViewControllerSpineLocation) pageViewController:(UIPageViewController *)pageViewController spineLocationForInterfaceOrientation:(UIInterfaceOrientation)orientation{
return UIPageViewControllerSpineLocationMin;
}
//設定分頁控制器的分頁數
- (NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController {
return 10;
}
//設定初始的分頁點
- (NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController{
return 0;
}
@end上面建立了最簡單的翻頁視圖控制器示例,效果如下圖:

三、UIPageViewController 中方法使用解析
//建立翻頁視圖控制器物件
- (instancetype)initWithTransitionStyle:(UIPageViewControllerTransitionStyle)style navigationOrientation:(UIPageViewControllerNavigationOrientation)navigationOrientation options:(nullable NSDictionary<NSString *, id> *)options;上面的方法用於建立視圖控制器物件,其中 UIPageViewControllerTransitionStyle 參數設定翻頁控制器的風格,列舉如下:
typedef NS_ENUM(NSInteger, UIPageViewControllerTransitionStyle) {
UIPageViewControllerTransitionStylePageCurl = 0, //類似書本翻頁效果
UIPageViewControllerTransitionStyleScroll = 1 //類似 ScrollView 的滑動效果
};如果設為 UIPageViewControllerTransitionStylePageCurl,翻頁效果如下圖所示:

初始化方法中的 UIPageViewControllerNavigationOrientation 屬性設定翻頁的方向,列舉如下:
typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationOrientation) {
UIPageViewControllerNavigationOrientationHorizontal = 0,//水平翻頁
UIPageViewControllerNavigationOrientationVertical = 1 //垂直翻頁
};options 參數用於設定翻頁視圖控制器的配置字典,可設定的配置鍵值如下:
//這個鍵需設為 UIPageViewControllerOptionSpineLocationKey 列舉值對應的 NSNumber 物件,設定翻頁控制器的書軸,後面會介紹
NSString * const UIPageViewControllerOptionSpineLocationKey;
//這個鍵需設為 NSNumber 類型,設定每頁視圖的間距,用於滾動視圖風格
NSString * const UIPageViewControllerOptionInterPageSpacingKey;下面是 UIPageViewController 的一些常用屬性與方法:
//設定資料來源
@property (nullable, nonatomic, weak) id <UIPageViewControllerDelegate> delegate;
//設定代理
@property (nullable, nonatomic, weak) id <UIPageViewControllerDataSource> dataSource;
//取得翻頁風格
@property (nonatomic, readonly) UIPageViewControllerTransitionStyle transitionStyle;
//取得翻頁方向
@property (nonatomic, readonly) UIPageViewControllerNavigationOrientation navigationOrientation;
//取得書軸類型
@property (nonatomic, readonly) UIPageViewControllerSpineLocation spineLocation;
//設定是否雙面顯示
@property (nonatomic, getter=isDoubleSided) BOOL doubleSided;
//設定要顯示的視圖控制器
- (void)setViewControllers:(nullable NSArray<UIViewController *> *)viewControllers direction:(UIPageViewControllerNavigationDirection)direction animated:(BOOL)animated completion:(void (^ __nullable)(BOOL finished))completion;上面只有 spineLocation 屬性有些難以理解,其列舉如下:
typedef NS_ENUM(NSInteger, UIPageViewControllerSpineLocation) {
//對於 ScrollView 類型的滑動效果,沒有書軸,會回傳下面這個列舉值
UIPageViewControllerSpineLocationNone = 0,
//以左邊或上邊為軸進行翻轉,界面同一時間只顯示一個 View
UIPageViewControllerSpineLocationMin = 1,
//以中間為軸進行翻轉,界面同時可以顯示兩個 View
UIPageViewControllerSpineLocationMid = 2,
//以下邊或右邊為軸進行翻轉,界面同一時間只顯示一個 View
UIPageViewControllerSpineLocationMax = 3
};將上面的示例程式碼修改幾個地方如下:
- (void)viewDidLoad {
[super viewDidLoad];
_pageViewControl = [[UIPageViewController alloc]initWithTransitionStyle:UIPageViewControllerTransitionStylePageCurl navigationOrientation:UIPageViewControllerNavigationOrientationVertical options:@{UIPageViewControllerOptionSpineLocationKey:@2,UIPageViewControllerOptionInterPageSpacingKey:@10}];
self.view.backgroundColor = [UIColor greenColor];
_pageViewControl.view.bounds=self.view.bounds;
_pageViewControl.dataSource=self;
_pageViewControl.delegate=self;
ModelViewController * model = [ModelViewController creatWithIndex:1];
ModelViewController * model2 = [ModelViewController creatWithIndex:2];
[_pageViewControl setViewControllers:@[model,model2] direction:UIPageViewControllerNavigationDirectionReverse animated:YES completion:nil];
_pageViewControl.doubleSided = YES;
_dataArray = [[NSMutableArray alloc]init];
[_dataArray addObject:model];
[self.view addSubview:_pageViewControl.view];
}
- (UIPageViewControllerSpineLocation) pageViewController:(UIPageViewController *)pageViewController spineLocationForInterfaceOrientation:(UIInterfaceOrientation)orientation{
return UIPageViewControllerSpineLocationMid;
}執行效果如下圖所示:

四、UIPageViewControllerDataSource 中方法解析
//向前翻頁展示的 ViewController
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController;
//向後翻頁展示的 ViewController
- (nullable UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController;
//設定分頁控制器的分頁點數
- (NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController NS_AVAILABLE_IOS(6_0);
//設定當前分頁控制器所高亮的點
- (NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController NS_AVAILABLE_IOS(6_0);
五、UIPageViewControllerDelegate 中方法解析
//翻頁視圖控制器將要翻頁時執行的方法
- (void)pageViewController:(UIPageViewController *)pageViewController willTransitionToViewControllers:(NSArray<UIViewController *> *)pendingViewControllers NS_AVAILABLE_IOS(6_0);
//翻頁動畫執行完成後回調的方法
- (void)pageViewController:(UIPageViewController *)pageViewController didFinishAnimating:(BOOL)finished previousViewControllers:(NSArray<UIViewController *> *)previousViewControllers transitionCompleted:(BOOL)completed;
//螢幕旋轉改變時回調的方法,可透過回傳值重設書軸類型列舉
- (UIPageViewControllerSpineLocation)pageViewController:(UIPageViewController *)pageViewController spineLocationForInterfaceOrientation:(UIInterfaceOrientation)orientation;