FSPagerView

FSPagerView is a Swift library for iOS developers who need to add a sliding card or banner component to an iPhone or Apple TV app. Think of the kind of image carousel you see at the top of many shopping apps, where photos automatically scroll sideways and dots at the bottom show which slide you are on. This library provides that kind of component, plus a range of visual transitions you can apply to make the sliding look more interesting.

The library works by wrapping Apple's built-in collection view system, but handling the paging, animation, and infinite-scroll logic for you so you do not have to build it from scratch. You can configure it to slide automatically on a timer, loop infinitely so there is no hard end to the list, scroll horizontally or vertically, and control how far each swipe moves. Item sizes and the spacing between items are adjustable.

For the visual transitions between slides, the README shows eight named styles with animated GIF previews: cross fading, zoom out, depth, linear, overlap, ferris wheel, inverted ferris wheel, cover flow, and cubic. You pick one by setting a single property. You can also create a custom transition by subclassing the transformer class the library provides.

The page indicator dots at the bottom are also configurable. You can set the number of dots, change the colors for selected and unselected states, swap dots for custom images, or change the shape to any path you draw with code.

Installation is available through CocoaPods, Carthage, or by copying the source files directly into an Xcode project. The library supports both Swift and Objective-C. The README includes step-by-step code examples and an explanation of how to connect the component using either code or Xcode's Interface Builder.