翻页控制器控件:UIPageViewController
介绍:
1、它是为我们提供了一种类似翻书效果的一种控件。我们可以通过使用UIPageViewController控件,来完成类似图书一样的翻页控制方式。使用Page View,用户可以方便的通过手势在多个页面之间导。
2、先假象一下,一本书大概可以分为:1.每一页。2.每一页中相应的数据。
使用UIPageViewController控件,也是类似的两个构成部分。要有一个书的框架,来控制页;每一页的内容。
创建一个ViewController,包含一个UIPageViewController来控制显示,一个NSArray包括所有数据。
定义这个ViewController类,并使用UIPageViewController来管理每一页,并提供数据。
3、可以只
添加1个PageContentViewController作为多个页的内容,因为引导页都非常相似,通过复用这个View Controller显然是更好的选择。
类型:
※导航方向枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationOrientation) {
//水平
//垂直
};
※书脊位置枚举,决定首页显示的视图个数
typedef NS_ENUM(NSInteger, UIPageViewControllerSpineLocation) {
UIPageViewControllerSpineLocationNone = 0,//没有书脊,滚动显示视图
// 书脊居左或上,首页显示一个视图
// 书脊居中,首页显示两个视图
// 书脊居右或下,显示一个视图
};
※翻页方式枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationDirection) {
//从左往右(或从下往上)翻页
UIPageViewControllerNavigationDirectionReverse //从右往左(或从上往下)翻页
};
※翻转样式枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerTransitionStyle) {
UIPageViewControllerTransitionStylePageCurl = 0, //翻书效果样式
//滑屏效果样式
};
图像关系:
详细的属性和方法:
※初始化,构建UIPageViewController实例
- (instancetype)initWithTransitionStyle:(UIPageViewControllerTransitionStyle)style navigationOrientation:(UIPageViewControllerNavigationOrientation)navigationOrientation options:(NSDictionary *)options;
说明:
UIPageViewControllerTransitionStyle枚举类型定义了如下两个翻转样式。
UIPageViewControllerTransitionStylePageCurl:翻书效果样式。
UIPageViewControllerTransitionStyleScroll:滑屏效果样式。
navigationOrientation设定翻页方向,UIPageViewControllerNavigationDirection枚举类型定义以下两种翻页方式。
UIPageViewControllerNavigationDirectionForward:从左往右(或从下往上);
UIPageViewControllerNavigationDirectionReverse:从右向左(或从上往下)。
※用于设置首页中显示的视图
- (void)setViewControllers:(NSArray *)viewControllers direction:(UIPageViewControllerNavigationDirection)direction animated:(BOOL)animated completion:(void (^)(BOOL finished))completion;
说明:
首页中显示几个视图与书脊类型有关,如果是UIPageViewControllerSpineLocationMin或UIPageViewControllerSpineLocationMax,首页中显示一个视图;如果是UIPageViewControllerSpineLocationMid,首页中显示两个视图。
※控制器代理
@property (nonatomic, assign) id <UIPageViewControllerDelegate> delegate;
※控制器数据源
@property (nonatomic, assign) id <UIPageViewControllerDataSource> dataSource;
※翻转样式
@property (nonatomic, readonly) UIPageViewControllerTransitionStyle transitionStyle;
※翻页方向
@property (nonatomic, readonly) UIPageViewControllerNavigationOrientation navigationOrientation;
※书脊位置
@property (nonatomic, readonly) UIPageViewControllerSpineLocation spineLocation;
※识别手势数组
@property(nonatomic, readonly) NSArray *gestureRecognizers;
※控制器数组
@property (nonatomic, readonly) NSArray *viewControllers;
※双面显示
@property (nonatomic, getter=isDoubleSided) BOOL doubleSided;
代理方法:
@protocol UIPageViewControllerDelegate <NSObject>
@optional
※gesture-initiated手势启动时触发的方法。
- (void)pageViewController:(UIPageViewController *)pageViewController willTransitionToViewControllers:(NSArray *)pendingViewControllers;
※ 当用户从一个页面转向下一个或者前一个页面,或者当用户开始从一个页面转向另一个页面的途中后悔 了,并撤销返回到了之前的页面时,将会调用这个方法。假如成功跳转到另一个页面时,transitionCompleted 会被置成 YES,假如在跳转途中取消了跳转这个动作将会被置成 NO。
- (void)pageViewController:(UIPageViewController *)pageViewController didFinishAnimating:(BOOL)finished previousViewControllers:(NSArray *)previousViewControllers transitionCompleted:(BOOL)completed;
※当设备的方向改变了将会调用这个方法。你可以使用这个方法通过返回UIPageViewControllerSpi呢location类型的一个值来设定页面主键的位置
- (UIPageViewControllerSpineLocation)pageViewController:(UIPageViewController *)pageViewController spineLocationForInterfaceOrientation:(UIInterfaceOrientation)orientation;
※返回页控制器中控制器的页内容控制器数
- (NSUInteger)pageViewControllerSupportedInterfaceOrientations:(UIPageViewController *)pageViewController;
※返回设置的书脊位置
- (UIInterfaceOrientation)pageViewControllerPreferredInterfaceOrientationForPresentation:(UIPageViewController *)pageViewController;
数据源方法:
@required(必须实现的方法)
※返回之前的控制器
- (UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController;
※返回之后的控制器
- (UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController;
@optional(可选的方法)
※返回页控制器中页的数量
- (NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController;
※返回页控制器中当前页的索引
- (NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController;
举例如下:(纯代码实现翻页功能)
类文件截图如下:
在PageContentViewContrller.h文件中声明必要的属性:
在PageContentViewController.m文件中对属性进行操作:
在ViewController.m文件才是真正实现翻页的功能的具体代码如下:
1.实现协议并声明属性:
2.懒加载初始化对象属性
3.初始化数据
4.创建翻页控制器实例
5.设置数据源和代理
6.创建内容控制器
7.设置翻页控制器控制器的子控制器
8.将翻页控制器添加到当前视图控制器中
9.实现数据源协议的方法:
//返回前一页
#pragma mark -数据源协议的方法
//返回前一页
-(UIViewController*)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController
{
//获取当前页
NSInteger index = ((PageContentViewController*) viewController).pageIndex;
if ((index == 0) || (index == NSNotFound))
{
return nil;
}
// 返回数据前关闭交互,确保只允许翻一页
pageViewController.view.userInteractionEnabled = NO;
//前一页
index --;
return [self viewControllersAtIndex:index];
}
//返回后一页
//返回后一页
-(UIViewController*)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController
{
//获取当前页
NSInteger index = ((PageContentViewController*) viewController).pageIndex;
if ((index == [self.arrayM count]-1) || (index == NSNotFound))
{
return nil;
}
// 返回数据前关闭交互,确保只允许翻一页
pageViewController.view.userInteractionEnabled = NO;
//后一页
index++;
return [self viewControllersAtIndex:index];
}
10.实现代理的方法
//防止上一个动画还没有结束,下一个动画就开始了
#pragma mark -代理的方法
-(void)pageViewController:(UIPageViewController *)pageViewController didFinishAnimating:(BOOL)finished previousViewControllers:(NSArray *)previousViewControllers transitionCompleted:(BOOL)completed
{
if(finished && completed)
{
// 无论有无翻页,只要动画结束就恢复交互。
pageViewController.view.userInteractionEnabled = YES;
}
}
11.自定义的附加的一个方法
//创建当前页的内容控制器
#pragma mark -返回当前页的控制器
-(PageContentViewController*)viewControllersAtIndex:(NSInteger)index
{
if ([self.arrayM count] == 0 || index == [self.arrayM count])
{
return nil;
}
//创建内容控制器
PageContentViewController *pageContentVC = [[PageContentViewController alloc]init];
pageContentVC.pageTitle = [self.arrayM objectAtIndex:index];
pageContentVC.view.backgroundColor = [UIColor grayColor];
pageContentVC.pageIndex = index;
return pageContentVC;
}
演示结果如下:
第0页: 第1页:
等等,一共十页,不做截图。