Class

UIPageViewController

A container view controller that manages navigation between pages of content, where each page is managed by a child view controller.

Overview

Page view controller–navigation can be controlled programmatically by your app or directly by the user using gestures. When navigating from page to page, the page view controller uses the transition that you specify to animate the change.

When defining a page view controller interface, you can provide the content view controllers one at a time (or two at a time, depending upon the spine position and double-sided state) or as-needed using a data source. When providing content view controllers one at a time, you use the setViewControllers(_:direction:animated:completion:) method to set the current content view controllers. To support gesture-based navigation, you must provide your view controllers using a data source object.

The data source for a page view controller is responsible for providing the content view controllers on demand and must conform to the UIPageViewControllerDataSource protocol. The delegate object—an object that conforms to the UIPageViewControllerDelegate protocol—provides some appearance-related information and receives notifications about gesture-initiated transitions.

This class is generally used as-is, but can also be subclassed.

Topics

Providing the Page Content

var dataSource: UIPageViewControllerDataSource?

The object that provides view controllers.

protocol UIPageViewControllerDataSource

The UIPageViewControllerDataSource protocol is adopted by an object that provides view controllers to the page view controller on an as-needed basis, in response to navigation gestures.

Customizing the Page View Behavior

protocol UIPageViewControllerDelegate

The delegate of a page view controller must adopt the UIPageViewControllerDelegate protocol. These methods allow the delegate to receive a notification when the device orientation changes and when the user navigates to a new page. For page-curl style transitions, the delegate can provide a different spine location in response to a change in the interface orientation.

Providing Content

var viewControllers: [UIViewController]?

The view controllers displayed by the page view controller.

var gestureRecognizers: [UIGestureRecognizer]

An array of UIGestureRecognizer objects that are configured to handle user interaction.

Display Options

var transitionStyle: UIPageViewControllerTransitionStyle

The style used to transition between view controllers.

var isDoubleSided: Bool

A Boolean value that indicates whether content appears on the back of pages.

Constants

enum UIPageViewControllerNavigationOrientation

Orientations for page-turn transitions.

enum UIPageViewControllerNavigationDirection

Directions for page-turn transitions.

enum UIPageViewControllerTransitionStyle

Styles for the page-turn transition.

Options Keys

Keys for the options dictionary.