UIPageViewController

UIPageViewController is a UIKit controller that manages navigation between a sequence of view controllers, presenting one page at a time and handling the gestures used to move between pages. It is commonly used for onboarding, tutorials, magazines, and other content organized into discrete pages.

The controller is created with a transition style and a navigation orientation. The transitionStyle can be .pageCurl, which mimics a page-turning effect, or .scroll, which provides a swipe-based paging experience. The navigationOrientation determines the direction of navigation, such as horizontal or vertical. UIPageViewController manages its child view controllers efficiently by loading only the current page and adjacent pages as needed.

A data source object must implement the two required methods to supply the neighboring pages: pageViewController(_:viewControllerBefore:) and pageViewController(_:viewControllerAfter:). Optional methods allow supplying a presentation count and a starting index for a page indicator. A delegate can respond to transition events, such as starting and finishing a page transition.

Programmatic navigation is supported via setViewControllers(_:direction:animated:completion:), which replaces the current page with a specified view controller in a chosen direction. The controller is typically embedded in a container view controller or added in a storyboard, with its dataSource and delegate set to an appropriate object. A key property is doubleSided, which affects the content shown on the reverse side of a page curl.

Common use cases include onboarding sequences and multi-page content flows, where the UIPageViewController provides a cohesive, page-based navigation experience.