一、前言
这些天有新生问及UIPageViewController这个视图控制器,自己原来没有用过,所以就看了一下相关的知识,就写了下来,分享一下经验。
主要的关于这个控制器的内容就从例子中去解说了。
再插一句:这个UIPageViewController一般用于引导页,就是第一次打开软件的时候显示的滑动页简介等。
二、最终效果
三、制作步骤:
第一步:我们首先新建一个SingleViewApplication。然后打开storyboard,在storyboard中 拖进来一个UIViewController 和一个UIPageViewController.如下图所示:
第二步:新建一个PageContentViewController,它是继承与UIViewController,这个视图用于控制显示的内容,同时设置刚才拖到storyboard中的UIViewController的class为PageContentViewController
同时设置Storyboard ID为PageContentController(可以随便设置),同时也设置刚才拖到storyboard的UIPageViewController的storyboard ID为PageViewController
,如上图所示。
第三步:在storyboardb中,在PageContentViewController中添加控件UILabel.并定义输出口。
在PageContentViewController.h中代码如下:
#import <UIKit/UIKit.h> @interface PageContentViewController : UIViewController @property(nonatomic,assign)NSUInteger pageIndex; //当前页面索引值 @property(nonatomic,strong)NSString *titleText; @property (weak, nonatomic) IBOutlet UILabel *contentLabel; @end
其中,pageIndex用来标识当前页的索引值,就是当前页面显示的第几页的页码。titleText就是contentLabel的内容。这时,在PageContentViewController.m中代码如下:
#import "PageContentViewController.h" @interface PageContentViewController () @end @implementation PageContentViewController - (void)viewDidLoad { [super viewDidLoad]; self.contentLabel.text = self.titleText; } @end
我们把titleText的内容给contentLabel。
接下来就是重头戏了。
第四步:我们在ViewController中(系统初始时的那个ViewController),新建一个NSArray用于盛放每一页显示的内容,即titleText的值数组。然后再实例化一个UIPageViewController。最后在ViewController中实现代理。
ViewController.h中代码如下:
#import <UIKit/UIKit.h> #import "PageContentViewController.h" @interface ViewController : UIViewController<UIPageViewControllerDataSource> @property(nonatomic,strong)NSArray *pageTitles; @property(nonatomic,strong)UIPageViewController *pageViewController; @end
第五步:主要在ViewController.m中操作:
1、实例化pageTitles:
self.pageTitles = [[NSArray alloc] initWithObjects:@"我是第一页",@"我是第二页",@"我是第三页",@"我是第四页", nil];
2、实例化pageViewController:
self.pageViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"PageViewController”];
这里用storyboard初始化该pageViewController。PageViewController为拖到storyboard中的UIPageViewController的storyboard ID。
3、实现协议:
self.pageViewController.dataSource = self;
在该类中主要有一下几种方法:
1、
-(PageContentViewController *)vidwControllerAtIndex:(NSUInteger)index { if (self.pageTitles.count== || index>=self.pageTitles.count) { return nil; } PageContentViewController *pageContentViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"PageContentController"]; pageContentViewController.view.backgroundColor = [UIColor lightGrayColor]; pageContentViewController.contentLabel.text = self.pageTitles[index]; pageContentViewController.pageIndex = index; return pageContentViewController; }
刚开始看这个方法好像很复杂的样子,其实很简单。就是根据index去得到想要显示的PageContentViewController.如果index=0或者超过了最大的页数,就返回空。
如果index没有越界,就实例话一个PageContentViewController,然后设置背景色,设置显示的页面的contentLabel.text,设置pageContentViewController的pageIndex。然后返回设置好的pageContentViewController。
2、
#pragma mark - PageViewControllerDataSource -(UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController { NSUInteger index = ((PageContentViewController *)viewController).pageIndex; if (index==||index==NSNotFound) { return nil; } index--; return [self vidwControllerAtIndex:index]; } -(UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController { NSUInteger index =((PageContentViewController *)viewController).pageIndex; if (index==NSNotFound) { return nil; } index++; if (index==[self.pageTitles count]) { return nil; } return [self vidwControllerAtIndex:index]; } //显示点的数量 -(NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController { // NSLog(@"%lu",(unsigned long)self.pageTitles.count); return [self.pageTitles count]; } //初始化选择哪一页 -(NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController { return ; }
很明显,这两个是UIPageViewController的代理方法。第一个是用于加载前一个pageContentController,该代理方法在向右滑动的时候触发。第二个是用于加载后一个pageContentController,该代理方法在向左滑动时触发。
就拿第一个来说吧。首先得到将要显示的viewController的pageIndex。因为需要判断是否到达第一个viewController.首先得到index,然后判断。然后加载要显示的页。
第二个方法是用于加载后一个viewController,其操作与第一个相反。就不多说了。
再后面的那两个方法一个用来设置需要显示的页数,一个用于设置初始化显示的第几页。
然后你可能会疑惑我们的显示内容的viewController是怎么加载到当前的页面的呢?其实也很简单。主要用到了下面的几个方法:(在viewdidload中)
PageContentViewController *startingViewController = [self vidwControllerAtIndex:]; NSArray *viewControllers = @[startingViewController]; [self.pageViewController setViewControllers:viewControllers direction:UIPageViewControllerNavigationDirectionForward animated:NO completion:nil]; self.pageViewController.view.frame = CGRectMake(, , self.view.frame.size.width, self.view.frame.size.height-); [self addChildViewController:self.pageViewController]; [self.view addSubview:self.pageViewController.view]; [self.pageViewController didMoveToParentViewController:self];
因为我们只是用了一个PageContentViewController,所以先得到该pageContentViewController。然后装入数组。
下面这个方法:
[self.pageViewController setViewControllers:viewControllers direction:UIPageViewControllerNavigationDirectionForwardanimated:NO completion:nil];
其作用就是把所有的pageContentViewContoller放到self.pageViewController。然后设置The navigation direction.
然后设置pageViewController的frame大小。
[self addChildViewController:self.pageViewController];这个方法是用于把pageViewController作为当前controller的子controller。 [self.view addSubview:self.pageViewController.view];把pageViewController的view加载到当前控制器的view上。 [self.pageViewController didMoveToParentViewController:self];这个方法感兴趣的可以自己查一下.
第六步:
运行你会发现没有下面的导航点,进行如下设置即可:
在AppDelegate.m中:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch. UIPageControl *pageControl = [UIPageControl appearance];
pageControl.pageIndicatorTintColor = [UIColor lightGrayColor];
pageControl.currentPageIndicatorTintColor = [UIColor blackColor];
pageControl.backgroundColor = [UIColor whiteColor];
return YES;
}
第七步:完成。
附viewController.m的源码:
#import "ViewController.h" @interface ViewController () @end @implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; self.pageTitles = [[NSArray alloc] initWithObjects:@"我是第一页",@"我是第二页",@"我是第三页",@"我是第四页", nil]; self.pageViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"PageViewController"]; self.pageViewController.dataSource = self; PageContentViewController *startingViewController = [self vidwControllerAtIndex:]; NSArray *viewControllers = @[startingViewController]; [self.pageViewController setViewControllers:viewControllers direction:UIPageViewControllerNavigationDirectionReverse animated:NO completion:nil]; self.pageViewController.view.frame = CGRectMake(, , self.view.frame.size.width, self.view.frame.size.height-); [self addChildViewController:self.pageViewController]; [self.view addSubview:self.pageViewController.view]; [self.pageViewController didMoveToParentViewController:self]; } #pragma mark - PageViewControllerDataSource -(UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerBeforeViewController:(UIViewController *)viewController { NSUInteger index = ((PageContentViewController *)viewController).pageIndex; if (index==||index==NSNotFound) { return nil; } index--; return [self vidwControllerAtIndex:index]; } -(UIViewController *)pageViewController:(UIPageViewController *)pageViewController viewControllerAfterViewController:(UIViewController *)viewController { NSUInteger index =((PageContentViewController *)viewController).pageIndex; if (index==NSNotFound) { return nil; } index++; if (index==[self.pageTitles count]) { return nil; } return [self vidwControllerAtIndex:index]; } -(PageContentViewController *)vidwControllerAtIndex:(NSUInteger)index { if (self.pageTitles.count== || index>=self.pageTitles.count) { return nil; } PageContentViewController *pageContentViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"PageContentController"]; pageContentViewController.view.backgroundColor = [UIColor lightGrayColor]; pageContentViewController.contentLabel.text = self.pageTitles[index]; pageContentViewController.pageIndex = index; return pageContentViewController; } //显示点的数量 -(NSInteger)presentationCountForPageViewController:(UIPageViewController *)pageViewController { // NSLog(@"%lu",(unsigned long)self.pageTitles.count); return [self.pageTitles count]; } //初始化选择哪一页 -(NSInteger)presentationIndexForPageViewController:(UIPageViewController *)pageViewController { return ; } @end