PageViewController

17 Mar 2025 | 4 分钟阅读

在 iOS 应用程序中，我们使用容器和内容视图控制器来显示应用程序的内容。然而，需要在应用程序的视图控制器之间进行导航，以便用户可以轻松地在视图控制器之间切换。在本教程的这一部分，我们将讨论 PageViewControlller，它是一个容器视图控制器，用于管理内容页面之间的导航，其中每个页面都由一个子视图控制器管理。它是 UIPageViewController 的实例，它继承自 UIViewController。

PageViewControlller 用于许多 iOS 应用程序中，使用户可以在应用程序的内容的各个页面之间导航。可以在应用程序中以编程方式控制导航。 PageViewController 使用我们指定的过渡来使更改产生动画效果。

UIPageViewControllers 属性

序号	属性	描述
1	var dataSource: UIPageViewControllerDataSource?	它是 UIPageViewControllerDataSource 协议的对象，该协议包含提供视图控制器进行导航的方法。
2	protocol UIPageViewControllerDataSource	协议 UIPageViewControllerDataSource 根据应用程序的请求提供视图控制器以响应导航手势。
3	var delegate: UIPageViewControllerDelegate?	它是页面视图控制器的委托对象。
4	protocol UIPageViewControllerDelegate	此协议包含在设备方向更改以及用户导航到新页面时通知的委托方法。
5	var viewControllers: [UIViewController]?	它是页面视图控制器显示的 UIViewControllers 列表。
6	var gestureRecognizers: [UIGestureRecognizer]	配置为处理用户交互的手势识别器对象列表。
7	var navigationOrientation: UIPageViewController.NavigationOrientation	这是导航的方向。
8	var spineLocation: UIPageViewController.SpineLocation	它表示脊柱的位置。
9	var transitionStyle: UIPageViewController.TransitionStyle	它是用于视图控制器之间过渡的样式。
10	var isDoubleSided: Bool	它是一个布尔值，指示内容是否显示在页面的背面。

UIPageViewController 函数

序号	方法	描述
1	func setViewControllers([UIViewController]?, direction: UIPageViewController.NavigationDirection, animated: Bool, completion: ((Bool) -> Void)?)	此方法用于设置页面视图控制器要显示的视图控制器。

示例

在此示例中，我们将创建一个包含两个视图控制器的项目，其中根页面视图控制器管理视图控制器之间的导航。

Main.storyboard

首先，我们需要将 PageViewController 添加到情节提要。为此，请在对象库中搜索 Page View Controller，然后将结果拖到情节提要。

这会将 Page View Controller 添加到情节提要中，如下图所示。我们将在属性检查器中将此视图控制器设置为初始视图控制器，并且还在标识检查器中将 RootPageViewController.swift 和情节提要 ID 分配给 RootVC。

由于我们添加的 PageViewController 用于管理不同视图控制器之间的导航。因此，在此项目中，我们还将添加两个视图控制器，如下图所示。我们为视图控制器提供了不同的背景颜色，以识别它们。我们还在标识检查器中为视图控制器提供了情节提要 ID，分别为 FirstVC 和 SecondVC。

在这里，我们构建了项目的情节提要。现在，我们将以编程方式在 RootPageViewController 类中定义导航。它符合 UIPageViewControllerDataSource 协议并实现其两种方法以返回当前视图控制器之前和之后的视图控制器。

RootPageViewController 类定义了导航发生在其间的视图控制器列表。使用 PageViewController 类的 setViewControllers() 方法将列表中存在的第一个视图控制器设置为当前视图控制器。

RootPageViewController.swift

import UIKit


class RootPageViewController: UIPageViewController {
    
    lazy var vcList:[UIViewController] = {
        let storyboard = UIStoryboard(name: "Main", bundle: nil)
        let firstVC = storyboard.instantiateViewController(identifier: "FirstVC")
        let secondVC = storyboard.instantiateViewController(identifier: "SecondVC")
        
        return [firstVC, secondVC]
        
    }()


    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        self.dataSource = self
        if let vc = vcList.first{
            self.setViewControllers([vc], direction: .forward, animated: true, completion: nil)
        }
        
    }
}


extension RootPageViewController : UIPageViewControllerDataSource{
    
    func pageViewController(_ pageViewController: UIPageViewController, viewControllerBefore viewController: UIViewController) -> UIViewController? {
        guard let index = vcList.lastIndex(of: viewController) else { return nil }
        let previousIndex = index - 1
        guard previousIndex >= 0 else {return nil}
        guard previousIndex < vcList.count else {return nil}
        return vcList[previousIndex]
        
    }
    func pageViewController(_ pageViewController: UIPageViewController, viewControllerAfter viewController: UIViewController) -> UIViewController? {
    guard let index = vcList.lastIndex(of: viewController) else { return nil }
        let previousIndex = index + 1
        guard previousIndex >= 0 else {return nil}
        guard previousIndex < vcList.count else {return nil}
        return vcList[previousIndex]


    }
}

输出