# FSPagerView
| SWIFT | [OBJECTIVE-C](https://github.com/WenchaoD/FSPagerView/blob/master/README-OBJECTIVE-C.md) |
|---|---|
**FSPagerView** is an elegant Screen Slide Library implemented primarily with ***UICollectionView***. It is extremely helpful for making Banner、Product Show、Welcome Pages、Screen/ViewController Sliders.
## Features
* ***Infinite*** scrolling.
* ***Automatic*** Sliding.
* Fully customizable item, with predefined banner-style item.
* Fully customizable ***page control***.
* Rich build-in 3D transformers.
* ***Simple*** and ***Delightful*** api usage.
* Support **SWIFT** and **OBJECTIVE-C**.
## Demos
* [Demo1 - Banner](#banner)
* [Demo2 - Transformer](#transformer)
* [Demo3 - Page Control](#page_control)
### Demo1 - Banner
| Banner |
|---|
| |
### automaticSlidingInterval
The time interval of automatic sliding. 0 means disabling automatic sliding. Default is 0.
**e.g.**
```swift
pagerView.automaticSlidingInterval = 3.0
```
### isInfinite
A boolean value indicates whether the pager view has infinite number of items. Default is false.
**e.g.**
```swift
pagerView.isInfinite = true
```
### itemSize
The item size of the pager view. .zero means always fill the bounds of the pager view. Default is .zero.
**e.g.**
```swift
pagerView.itemSize = CGSize(width: 200, height: 180)
```
### interitemSpacing
The spacing to use between items in the pager view. Default is 0.
**e.g.**
```swift
pagerView.interitemSpacing = 10
```
## Demo2 - Transformers
|Cross Fading|
|---|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .crossfading)
```
---
|Zoom Out|
|---|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .zoomout)
```
---
|Depth|
|---|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .depth)
```
---
|Linear|
|---|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .linear)
```
---
|Overlap|
|---|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .overlap)
```
---
|Ferris Wheel|
|------|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .ferrisWheel)
```
---
|Inverted Ferris Wheel|
|------|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .invertedFerrisWheel)
```
---
|Cover Flow|
|------|
|  |
```swift
pagerView.transformer = FSPagerViewTransformer(type: .coverFlow)
```
---
> Customize your own transformer by subclassing`FSPagerViewTransformer.`
## Demo3 Page Control
|Page Control|
|---|
|
|
### numberOfPages
The number of page indicators of the page control. Default is 0.
**e.g.**
```swift
pageControl.numberOfPages = 5
```
### currentPage
The current page, highlighted by the page control. Default is 0.
**e.g.**
```swift
pageControl.currentPage = 1
```
### setStrokeColor:forState:
Sets the stroke color for page indicators to use for the specified state. (selected/normal).
**e.g.**
```swift
pageControl.setStrokeColor(.green, for: .normal)
pageControl.setStrokeColor(.yellow, for: .selected)
```
### setFillColor:forState:
Sets the fill color for page indicators to use for the specified state. (selected/normal).
**e.g.**
```swift
pageControl.setFillColor(.gray, for: .normal)
pageControl.setFillColor(.white, for: .selected)
```
### setImage:forState:
Sets the image for page indicators to use for the specified state. (selected/normal).
**e.g.**
```swift
pageControl.setImage(UIImage(named:"image1"), for: .normal)
pageControl.setImage(UIImage(named:"image2"), for: .selected)
```
### setPath:forState:
Sets the path for page indicators to use for the specified state. (selected/normal).
**e.g.**
```swift
pageControl.setPath(UIBezierPath(rect: CGRect(x: 0, y: 0, width: 8, height: 8)), for: .normal)
pageControl.setPath(UIBezierPath(ovalIn: CGRect(x: 0, y: 0, width: 8, height: 8)), for: .normal)
```
## Installation
* Manually
* Cocoapods
### Manually
1. ***[Download](#)*** the source code.
2. Extract the zip file, simply drag folder ***FSPagerView*** into your project.
3. Make sure ***Copy items if needed*** is checked.
### Cocoapods
```ruby
use_frameworks!
pod FSPagerView
```
## Tutorial
* [Get start](#get_start)
* [Implement FSPagerViewDataSource](#implement_fspagerviewdatasource)
* [Implement FSPagerViewDelegate](#implement_fspagerviewdelegate)
### 1. Get start
* Get start with code
```swift
// Create a pager view
let pagerView = FSPagerView(frame: frame1)
pagerView.dataSource = self
pagerView.delegate = self
pagerView.register(FSPagerViewCell.self, forCellWithReuseIdentifier: "cell")
self.view.addSubview(pagerView)
// Create a page control
let pageControl = FSPagerControl(frame: frame2)
self.view.addSubview(pageControl)
```
* Get start with Interface Builder
1、Simply drag **UIView** instance into your View Controller, Change the `Custom Class` to `FSPagerView`. (Or `FSPageControl`)
2、Link the `dataSource` and `delegate` property of **FSPagerView** to your View Controller.
3、Register a cell class.
```swift
@IBOutlet weak var pagerView: FSPagerView! {
didSet {
self.pagerView.register(FSPagerViewCell.self, forCellWithReuseIdentifier: "cell")
}
}
```
### 2. Implement FSPagerViewDataSource
```swift
public func numberOfItems(in pagerView: FSPagerView) -> Int {
return numberOfItems
}
public func pagerView(_ pagerView: FSPagerView, cellForItemAt index: Int) -> FSPagerViewCell {
let cell = pagerView.dequeueReusableCell(withReuseIdentifier: "cell", at: index)
cell.imageView?.image = ...
cell.textLabel?.text = ...
return cell
}
```
### 3. Implement FSPagerViewDelegate
```swift
func pagerView(_ pagerView: FSPagerView, shouldHighlightItemAt index: Int) -> Bool
```
> Asks the delegate if the item should be highlighted during tracking.
---
```swift
func pagerView(_ pagerView: FSPagerView, didHighlightItemAt index: Int)
```
> Tells the delegate that the item at the specified index was highlighted.
---
```swift
func pagerView(_ pagerView: FSPagerView, shouldSelectItemAt index: Int) -> Bool
```
> Asks the delegate if the specified item should be selected.
---
```swift
func pagerView(_ pagerView: FSPagerView, didSelectItemAt index: Int)
```
> Tells the delegate that the item at the specified index was selected.
---
```swift
func pagerView(_ pagerView: FSPagerView, willDisplay cell: FSPagerViewCell, forItemAt index: Int)
```
> Tells the delegate that the specified cell is about to be displayed in the pager view.
---
```swift
func pagerView(_ pagerView: FSPagerView, didEndDisplaying cell: FSPagerViewCell, forItemAt index: Int)
```
> Tells the delegate that the specified cell was removed from the pager view.
---
```swift
func pagerViewWillBeginDragging(_ pagerView: FSPagerView)
```
> Tells the delegate when the pager view is about to start scrolling the content.
---
```swift
func pagerViewWillEndDragging(_ pagerView: FSPagerView, targetIndex: Int)
```
> Tells the delegate when the user finishes scrolling the content.
---
```swift
func pagerViewDidScroll(_ pagerView: FSPagerView)
```
> Tells the delegate when the user scrolls the content view within the receiver.
---
```swift
func pagerViewDidEndScrollAnimation(_ pagerView: FSPagerView)
```
> Tells the delegate when a scrolling animation in the pager view concludes.
---
```swift
func pagerViewDidEndDecelerating(_ pagerView: FSPagerView)
```
> Tells the delegate that the pager view has ended decelerating the scrolling movement.
---
## Support this repo
* ***Star*** this repo 
* Buy me a Coffee. ☕️
|
|
---
## Author
* ***微博：[@WenchaoD](http://weibo.com/WenchaoD)***
* ***Twitter: [@WenchaoD](https://twitter.com/WenchaoD)***
* Other repos:
* 
***[FSCalendar](https://github.com/WenchaoD/FSCalendar)***
|
---
## Author
* ***微博：[@WenchaoD](http://weibo.com/WenchaoD)***
* ***Twitter: [@WenchaoD](https://twitter.com/WenchaoD)***
* Other repos:
*