iOS:UIPageViewController翻页控制器控件详细介绍

时间:2024-05-19 16:14:29

翻页控制器控件: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      //滑屏效果样式

};

 
 
图像关系:
iOS:UIPageViewController翻页控制器控件详细介绍
 
 
 
iOS:UIPageViewController翻页控制器控件详细介绍
 
iOS:UIPageViewController翻页控制器控件详细介绍

详细的属性和方法:
※初始化,构建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; 

 
举例如下:(纯代码实现翻页功能)
   类文件截图如下:
   iOS:UIPageViewController翻页控制器控件详细介绍
 
   在PageContentViewContrller.h文件中声明必要的属性:
   iOS:UIPageViewController翻页控制器控件详细介绍
 
   在PageContentViewController.m文件中对属性进行操作:
   iOS:UIPageViewController翻页控制器控件详细介绍
 
   在ViewController.m文件才是真正实现翻页的功能的具体代码如下:
   1.实现协议并声明属性:
   iOS:UIPageViewController翻页控制器控件详细介绍
 
 
   2.懒加载初始化对象属性
   iOS:UIPageViewController翻页控制器控件详细介绍
 
 
   3.初始化数据
   iOS:UIPageViewController翻页控制器控件详细介绍
 
 
   4.创建翻页控制器实例
   iOS:UIPageViewController翻页控制器控件详细介绍
 
 
   5.设置数据源和代理
   iOS:UIPageViewController翻页控制器控件详细介绍
 
 
 
   6.创建内容控制器
   iOS:UIPageViewController翻页控制器控件详细介绍
 
   7.设置翻页控制器控制器的子控制器
   iOS:UIPageViewController翻页控制器控件详细介绍
 
   8.将翻页控制器添加到当前视图控制器中
   iOS:UIPageViewController翻页控制器控件详细介绍
   
 
   9.实现数据源协议的方法:
//返回前一页
iOS:UIPageViewController翻页控制器控件详细介绍
#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];
    
}
iOS:UIPageViewController翻页控制器控件详细介绍

//返回后一页

iOS:UIPageViewController翻页控制器控件详细介绍
//返回后一页
-(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];
}
iOS:UIPageViewController翻页控制器控件详细介绍

    10.实现代理的方法

//防止上一个动画还没有结束,下一个动画就开始了

iOS:UIPageViewController翻页控制器控件详细介绍
#pragma mark -代理的方法
-(void)pageViewController:(UIPageViewController *)pageViewController didFinishAnimating:(BOOL)finished previousViewControllers:(NSArray *)previousViewControllers transitionCompleted:(BOOL)completed
{
    if(finished && completed)
    {
        // 无论有无翻页,只要动画结束就恢复交互。
        pageViewController.view.userInteractionEnabled = YES;
    }
}
iOS:UIPageViewController翻页控制器控件详细介绍

      11.自定义的附加的一个方法

//创建当前页的内容控制器

iOS:UIPageViewController翻页控制器控件详细介绍
#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;
}
iOS:UIPageViewController翻页控制器控件详细介绍

 

演示结果如下:

 第0页:                                                                      第1页:

iOS:UIPageViewController翻页控制器控件详细介绍    iOS:UIPageViewController翻页控制器控件详细介绍

等等,一共十页,不做截图。

程序猿神奇的手,每时每刻,这双手都在改变着世界的交互方式!
分类: iOS初级

本文转自当天真遇到现实博客园博客,原文链接:http://www.cnblogs.com/XYQ-208910/p/4848781.html,如需转载请自行联系原作者