翻页控制器控件:UIPageViewController
介绍:
1、它是为我们提供了一种类似翻书效果的一种控件。我们可以通过使用UIPageViewController控件,来完成类似图书一样的翻页控制方式。使用Page View,用户可以方便的通过手势在多个页面之间导。
2、先假象一下,一本书大概可以分为:1.每一页。2.每一页中相应的数据。使用UIPageViewController控件,也是类似的两个构成部分。要有一个书的框架,来控制页;每一页的内容。创建一个ViewController,包含一个UIPageViewController来控制显示,一个NSArray包括所有数据。定义这个ViewController类,并使用UIPageViewController来管理每一页,并提供数据。 3、可以只添加1个PageContentViewController作为多个页的内容,因为引导页都非常相似,通过复用这个View Controller显然是更好的选择。
类型:
※导航方向枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationOrientation) {
UIPageViewControllerNavigationOrientationHorizontal = 0, //水平
UIPageViewControllerNavigationOrientationVertical = 1 //垂直
};
※书脊位置枚举,决定首页显示的视图个数
typedef NS_ENUM(NSInteger, UIPageViewControllerSpineLocation) {
UIPageViewControllerSpineLocationNone = 0, //没有书脊,滚动显示视图
UIPageViewControllerSpineLocationMin = 1, // 书脊居左或上,首页显示一个视图
UIPageViewControllerSpineLocationMid = 2, // 书脊居中,首页显示两个视图
UIPageViewControllerSpineLocationMax = 3 // 书脊居右或下,显示一个视图
};
※翻页方式枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerNavigationDirection) {
UIPageViewControllerNavigationDirectionForward, //从左往右(或从下往上)翻页
UIPageViewControllerNavigationDirectionReverse //从右往左(或从上往下)翻页
};
※翻转样式枚举
typedef NS_ENUM(NSInteger, UIPageViewControllerTransitionStyle) {
UIPageViewControllerTransitionStylePageCurl = 0, //翻书效果样式
UIPageViewControllerTransitionStyleScroll = 1 //滑屏效果样式
};
详细的属性和方法:※初始化,构建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 == ) || (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]-) || (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] == || 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页:
等等,一共十页,不做截图。