How to create custom menu cells in PageController?

Implement the MenuBarCellable protocol with methods like setTitle and setHighlighted, then register your custom cell class or nib using the provided functions in MenuBar. This allows full control over menu appearance and interaction, as detailed in the README.

PageController vs UIPageViewController: which is better for iOS?

PageController excels in infinite paging with smooth, delayed animations and high customizability, while UIPageViewController is a standard Apple component for basic page navigation with less overhead. Choose PageController for enhanced visual effects and flexibility in tabbed interfaces.

Can PageController be used with SwiftUI?

PageController is built on UIKit, so integration with SwiftUI requires wrapping it in a UIViewControllerRepresentable, which adds complexity and might not offer the seamless experience of native SwiftUI components. It's best suited for UIKit-based projects.

How to handle delegate methods for view controller changes?

Use the delegate methods provided by PageController to notify changes in the current view controller. Implement the delegate pattern similar to other iOS controllers, allowing you to respond to navigation events and update your app state accordingly.

What are the performance implications of infinite paging?

PageController is designed for smooth scrolling, but infinite paging can lead to memory issues if view controllers are not efficiently managed. Ensure proper view controller lifecycle handling, such as lazy loading or caching, to maintain performance in content-heavy apps.

Is PageController still actively maintained?

The README shows badges for Travis CI and support for recent Swift versions, indicating some maintenance. However, check the GitHub repository for recent commits and issue activity to assess current support, as it might have slowed over time.

Open-Awesome

PageController

MITSwift

An infinite paging controller for iOS with smooth scrolling and delayed title bar movement.

GitHub

408 stars43 forks0 contributors

What is PageController?

PageController is an iOS library written in Swift that provides infinite paging navigation between view controllers. It allows users to scroll seamlessly through content while the title bar scrolls with a delay, creating a smooth and visually appealing interaction. It solves the need for a customizable, fluid paging interface in iOS apps.

Target Audience

iOS developers building apps that require smooth, infinite paging navigation between multiple view controllers, such as tabbed interfaces or content browsers.

Value Proposition

Developers choose PageController for its smooth scrolling, delayed title bar animation, and high customizability, including support for custom menu cells and AutoLayout, making it a flexible alternative to standard iOS paging components.

Overview

Infinite paging controller, scrolling through contents and title bar scrolls with a delay

Use Cases

Best For

Building tabbed interfaces with infinite scrolling
Creating smooth content browsers or galleries
Implementing custom navigation menus with delayed animations
Developing iOS apps that require fluid page transitions
Adding infinite paging to onboarding or tutorial screens
Replacing standard UIPageViewController with more customization

Not Ideal For

Projects requiring standard UIKit paging without infinite scrolling or custom animations
Apps built primarily with SwiftUI that prefer native declarative components
Teams needing extensive out-of-the-box accessibility features without custom implementation

Pros & Cons

Pros

Infinite Paging Navigation

Enables seamless scrolling through an unlimited number of view controllers, providing a fluid experience for content-heavy iOS apps, as highlighted in the key features.

Smooth Delayed Animation

The title bar scrolls with a delay, creating a visually appealing and intuitive navigation effect, demonstrated in the example GIF for enhanced user interaction.

UIKit Integration

Uses UIViewController instances like UITabBarController, making it familiar to iOS developers and easy to integrate into existing UIKit-based projects.

High Customizability

Supports custom menu cells via the MenuBarCellable protocol and allows adjustments to MenuBar properties like backgroundColor and frame, offering flexibility in design as shown in the usage examples.

Cons

Dependency on DCScrollView

Inherits from DCScrollView, an external library by the same author, which adds complexity and potential maintenance risks if that dependency is not well-supported.

Limited Advanced Documentation

The README provides basic usage but lacks detailed tutorials or examples for complex scenarios, such as handling memory management with infinite view controllers.

Version Compatibility Challenges

Tied to specific Swift and Xcode versions (e.g., 0.7.x for Swift 4.1), requiring careful migration and potentially introducing breaking changes, as noted in the requirements table.

Frequently Asked Questions

Related Projects

Material

A UI/UX framework for creating beautiful applications.

Stars11,983

Forks1,259

Last commit4 years ago

FSPagerView

FSPagerView is an elegant Screen Slide Library. It is extremely helpful for making Banner View、Product Show、Welcome/Guide Pages、Screen/ViewController Sliders.

Stars7,371

Forks1,070

Last commit1 year ago

Material Components

[In maintenance mode] Modular and customizable Material Design UI components for iOS

Stars4,773

Forks955

Last commit11 months ago

CHIPageControl

A set of cool animated page controls written in Swift to replace boring UIPageControl. Mady by @ChiliLabs - https://chililabs.io

Stars3,467

Forks264

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub