How do I make FSPagerView slide automatically?

Set the automaticSlidingInterval property to a positive value (e.g., 3.0 for 3 seconds) as shown in the README's Banner demo. This enables timed transitions between slides without user interaction.

FSPagerView or UIPageViewController: which should I use for a simple image slider?

FSPagerView is better for rich animations and infinite scrolling, while UIPageViewController is more native but limited in effects. For banners with transforms, FSPagerView saves development time.

Can I use FSPagerView with SwiftUI?

Not directly, as it's a UIKit-based library. You'll need to wrap it in a UIViewRepresentable to integrate with SwiftUI, adding complexity to the setup.

How to change the page control dots to custom images in FSPagerView?

Use the setImage:forState: method on FSPageControl, as demonstrated in Demo3. Provide different images for normal and selected states to fully customize the appearance.

Does FSPagerView support vertical scrolling?

Yes, it supports both horizontal and vertical paging orientations through configuration, making it versatile for different layout needs as mentioned in the features.

How to handle performance with many images in FSPagerView?

Since it's built on UICollectionView, implement efficient cell recycling and image caching. The library doesn't provide built-in optimizations, so you must manage memory manually for large datasets.

Open-Awesome

FSPagerView

MITSwift

An elegant screen slide library for iOS and tvOS, perfect for creating banners, product showcases, and onboarding sliders.

GitHub

7.4k stars1.1k forks0 contributors

What is FSPagerView?

FSPagerView is an open-source screen slide library for iOS and tvOS, built using UICollectionView. It enables developers to easily create interactive, animated pager views for displaying content like banners, product showcases, and onboarding guides. The library solves the problem of implementing complex, performant sliders by providing a ready-to-use component with extensive customization options.

Target Audience

iOS and tvOS developers who need to implement carousels, banners, onboarding sliders, or product showcases in their applications. It's particularly useful for those working with Swift or Objective-C who want a feature-rich, native alternative to building custom solutions from scratch.

Value Proposition

Developers choose FSPagerView for its elegant API, rich set of built-in animations (transformers), and deep customization capabilities for both the pager view and page control. It stands out by offering professional-grade slide functionality with support for infinite scrolling, automatic sliding, and dual language (Swift/Objective-C) compatibility, all while being lightweight and easy to integrate.

Overview

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

Use Cases

Best For

Creating infinite-scrolling banner ads or promotional carousels in iOS apps
Building interactive product showcases or image galleries for e-commerce applications
Implementing animated welcome or tutorial sliders for user onboarding
Developing custom screen sliders or view controller transitions
Adding visually rich, animated page controls to content sliders
Prototyping or building production UIs that require horizontal or vertical paging

Not Ideal For

Projects targeting cross-platform frameworks like React Native or Flutter
Apps where accessibility compliance (e.g., VoiceOver) is a primary requirement without additional work
Scenarios needing real-time data synchronization or dynamic content loading beyond static sliders

Pros & Cons

Pros

Rich Animation Library

Offers multiple built-in 3D transformers such as cross-fade, zoom, and cover flow, easily applied with a single line of code as shown in Demo2.

Seamless Infinite Scrolling

Enables continuous looping of content items through the isInfinite property, perfect for banners and showcases without manual resetting.

Highly Customizable Controls

Provides extensive styling options for page indicators, including custom images and shapes, detailed in Demo3 with setImage:forState: and setPath:forState: methods.

Dual Language Support

Fully compatible with both Swift and Objective-C, with separate documentation and examples for each language.

Cons

Platform Exclusivity

Limited to iOS and tvOS, so it cannot be used in macOS, watchOS, or multi-platform projects, restricting its utility.

Undocumented Accessibility

The README makes no mention of accessibility features, requiring developers to manually implement support for screen readers like VoiceOver.

Customization Complexity

Creating custom transformers requires subclassing FSPagerViewTransformer, which may be daunting for developers unfamiliar with Core Animation or similar frameworks.

Frequently Asked Questions

Related Projects

Material

A UI/UX framework for creating beautiful applications.

Stars12,005

Forks1,257

Last commit4 years ago

Material Components

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

Stars4,769

Forks962

Last commit1 year ago

BouncyLayout

Make. It. Bounce.

Stars4,237

Forks196

Last commit6 years ago

RKNotificationHub

Make any UIView a full fledged notification center

Stars3,041

Forks321

Last commit7 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