https://github.com/Ramotion/cardslider
:octocat: 🃏 Cardslider is a design UI controller that allows you to swipe through cards with pictures and accompanying descriptions.
https://github.com/Ramotion/cardslider
ios swift
Last synced: 7 months ago
JSON representation
:octocat: 🃏 Cardslider is a design UI controller that allows you to swipe through cards with pictures and accompanying descriptions.
- Host: GitHub
- URL: https://github.com/Ramotion/cardslider
- Owner: Ramotion
- License: mit
- Created: 2018-10-02T14:31:02.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-06T06:51:34.000Z (over 5 years ago)
- Last Synced: 2025-04-08T16:08:36.755Z (7 months ago)
- Topics: ios, swift
- Language: Swift
- Homepage: https://www.ramotion.com/iphone-app-development-ui-library-for-swiping-through-objects/
- Size: 21.8 MB
- Stars: 1,275
- Watchers: 34
- Forks: 103
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - cardslider - Cardslider is a design UI controller that allows you to swipe through cards with pictures and accompanying descriptions. [•](https://raw.githubusercontent.com/Ramotion/cardslider/master/iOS_Card_Slider.gif) (Content / Collection View)
README
CARD SLIDER
UI controller that allows you to swipe through cards with pictures.
___
We specialize in the designing and coding of custom UI for Mobile Apps and Websites.
Stay tuned for the latest updates:
#### Inspired by [Charles Patterson](https://dribbble.com/CharlesPatterson) [shot](https://dribbble.com/shots/3982621-InVision-Studio-Movies-app-concept)
[](http://twitter.com/Ramotion)
[](https://paypal.me/Ramotion)
## Requirements
- iOS 11.0+
- Xcode 10.0+
## Installation
Use [CocoaPods](https://cocoapods.org) with Podfile:
```
pod 'CardSlider'
```
or [Carthage](https://github.com/Carthage/Carthage) users can simply add CardSlider to their `Cartfile`:
```
github "Ramotion/CardSlider"
```
Then import the module in your code:
``` swift
import CardSlider
```
## Usage
1) Declare a card model, implementing `CardSliderItem` protocol:
``` swift
public protocol CardSliderItem {
var image: UIImage { get }
var rating: Int? { get }
var title: String { get }
var subtitle: String? { get }
var description: String? { get }
}
```
2) Implement `CardSliderDataSource` methods in your class:
``` swift
public protocol CardSliderDataSource: class {
func item(for index: Int) -> CardSliderItem
func numberOfItems() -> Int
}
```
3) Create an instance of `CardSliderViewController` with the data source:
``` swift
guard let dataSource = someObject as? CardSliderDataSource else { return }
let cardSlider = CardSliderViewController.with(dataSource: dataSource)
```
4) Set the title and present:
``` swift
cardSlider.title = "Movies"
present(cardSlider, animated: true, completion: nil)
```
## 📄 License
Card Slider is released under the MIT license.
See [LICENSE](./LICENSE) for details.
This library is a part of a selection of our best UI open-source projects.
If you use the open-source library in your project, please make sure to credit and backlink to www.ramotion.com
## 📱 Get the Showroom App for iOS to give it a try
Try this UI component and more like this in our iOS app. Contact us if interested.
