在 Swift 中使用 UIPageViewController 流畅地浏览内容

2023-12-27 07:31:20

UIPageViewController 简介

UIPageViewController 是一个容器视图控制器，可让您在应用程序中创建基于页面的界面。它提供了一个简单的界面，允许用户左右滑动页面，就像在书籍中翻页一样。UIPageViewController 非常适合展示一系列相关内容，例如产品图片、文章或设置选项。

定制选项

UIPageViewController 提供了一系列定制选项，使您可以根据自己的应用程序需求对其进行定制。这些选项包括：

页面内容： 您可以使用 viewControllers 属性指定要显示在 UIPageViewController 中的视图控制器。
页面指示器： 您可以使用 pageIndicator 属性显示页面指示器，指示当前所选页面。
页面滚动方向： 您可以使用 spineLocation 属性设置 UIPageViewController 的页面滚动方向。
页面间距： 您可以使用 interpageSpacing 属性设置页面之间的间距。

动画

UIPageViewController 支持多种动画效果，让您可以在页面之间进行流畅的过渡。这些动画包括：

滑动动画： 这是默认动画，它允许用户通过水平滑动在页面之间导航。
翻转动画： 此动画提供了一个 3D 翻转效果，在页面之间切换时显示页面背面。
自定义动画： 您可以使用 transitionCoordinator 属性创建自己的自定义动画。

手势识别

UIPageViewController 支持各种手势，包括：

轻扫： 用户可以左右滑动以在页面之间导航。
点击： 用户可以点击页面指示器以直接跳转到特定页面。
拖动： 用户可以拖动页面指示器以查看页面预览。

实现

要使用 UIPageViewController，您需要：

创建一个包含您要显示的视图控制器的数组。
创建一个 UIPageViewController 实例，并将其 pageViewControllers 属性设置为包含视图控制器的数组。
将 UIPageViewController 添加到您的应用程序视图层次结构中。

您可以使用 dataSource 和 delegate 属性进一步定制 UIPageViewController 的行为。

示例代码

以下示例代码演示了如何创建一个 UIPageViewController，其中包含三个包含文本标签的视图控制器：

import UIKit

class ViewController: UIViewController {

    private var pageViewController: UIPageViewController!
    private var pages: [UIViewController] = []

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 创建视图控制器数组
        for i in 0..<3 {
            let vc = UIViewController()
            vc.view.backgroundColor = .random()
            vc.title = "Page \(i + 1)"
            pages.append(vc)
        }
        
        // 创建 UIPageViewController
        pageViewController = UIPageViewController(transitionStyle: .scroll, navigationOrientation: .horizontal, options: nil)
        pageViewController.dataSource = self
        pageViewController.delegate = self
        pageViewController.setViewControllers([pages[0]], direction: .forward, animated: true, completion: nil)
        
        // 添加 UIPageViewController 到视图层次结构中
        addChild(pageViewController)
        view.addSubview(pageViewController.view)
        pageViewController.didMove(toParent: self)
    }
}

extension ViewController: UIPageViewControllerDataSource {

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

extension ViewController: UIPageViewControllerDelegate {

    func pageViewController(_ pageViewController: UIPageViewController, willTransitionTo pendingViewControllers: [UIViewController]) {
        print("Will transition to view controller: \(pendingViewControllers[0])")
    }
    
    func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
        print("Did finish animating: \(finished), completed: \(completed)")
    }
}