A Swift image slider component based on UICollectionView
Swift Shell Objective-C Ruby C
Latest commit 466f815 Apr 5, 2016 @frederik-jacques Merge pull request #2 from datomnurdin/master
Update README.md

README.md

TNImageSliderViewController

Version License Platform

What

TNImageSliderViewController is an image slider component written in Swift. It creates a slideshow of images which can slide horizontal or vertical. This component can deal with orientation changes.

Demo

Demo

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

TNImageSliderViewController is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'TNImageSliderViewController'

Using storyboards

  • Add a container view to your Storyboard.
  • Set the class in the Identity Inspector to TNImageSliderViewController
  • Set the module field to TNImageSliderViewController if you work with CocoaPods
  • Give the embed segue a name e.g seg_imageSlider
  • Go to the ViewController class in which you have embedded the TNImageSliderViewController class
  • At the top of the file, import TNImageSliderViewController
  • Create a property to hold the instance of TNImageSliderViewController
  • Fill in this property in prepareForSegue:identifier:
  • Set the images property of the TNImageSliderViewController to an array of UIImage objects, only set this property after the viewDidLoad method has been executed or you will get a runtime error

If you want, you can also set the options property (instance of TNImageSliderViewOptions)

Option What does it do?
scrollDirection Set the collectionview to scroll horizontal or vertical
backgroundColor A UIColor object to set the background color of the collectionview
pageControlHidden Hides the UIPageControl
pageControlCurrentIndicatorTintColor A UIColor object to set the indicator color
pageControlCurrentIndicatorTintColor A UIColor object to set the indicator color
shouldStartFromBeginning Boolean, start at the first picture
imageContentMode UIViewContentMode, How should the images be scaled

Delegate

If you want to be informed that the image slider has scrolled to a specific page, you can set the delegate property. The delegate has one method imageSlider( imageSlider:TNImageSliderViewController, didScrollToPage pageNumber:Int )

Author

Frederik Jacques, frederik@the-nerd.be

License

TNImageSliderViewController is available under the MIT license. See the LICENSE file for more info.