Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/binchik/SubscriptionPrompt

Subscription View Controller like the Tinder uses
https://github.com/binchik/SubscriptionPrompt

Last synced: about 2 months ago
JSON representation

Subscription View Controller like the Tinder uses

Lists

README 

        
# SubscriptionPrompt

SubscriptionPrompt is a UIViewController with a carousel at the top and a number of rows at the bottom. Written in Swift, works for Objective-C as well.



SubscriptionPrompt screenshot



# Installation



#### CocoaPods

You can use [CocoaPods](http://cocoapods.org/) to install `SubscriptionPrompt` by adding it to your `Podfile`:



```ruby

platform :ios, '8.0'

use_frameworks!

pod 'SubscriptionPrompt'

```



#### Manually

Download and drop ```/SubscriptionPrompt```folder in your project.  



# Usage



Just initialize the SubscriptionViewontroller with the following constructor, 

you can omit some parameters since they have default values:



```swift

init(title: String? = nil, slides: [Slide], options: [Option],

	cancelMessage: String? = nil, restoreButtonTitle: String? = nil)

```



and present it.



`Slide` and `Option` are structs, use the following inits to create them:



```swift

init(image: UIImage?, title: String?, subtitle: String?)

init(title: String?, checked: Bool = false)

```



To get the index of tapped rows, implement the SubscriptionViewControllerDelegate.



```swift

override func viewDidLoad() {

      super.viewDidLoad()

      subscriptionViewController.delegate = self

}



func subscriptionViewControllerRowTapped(atIndex index: Int) {

    print("tapped index: \(index)")

}

```



`animateDraggingToTheRight(duration:)` - animates a little drag to the right and back with the given duration 

[ux hint for the user that the carousel is draggable]



# Styles customization



Set `stylingDelegate: SubscriptionViewControllerStylingDelegate` to customize styles. 

There are three optional methods:



```swift

optional func subscriptionViewControllerSlideStyle(atIndex index: Int) -> SlideStyle

optional func subscriptionViewControllerOptionStyle(atIndex index: Int) -> OptionStyle

optional func subscriptionViewControllerNotNowButtonStyle() -> OptionStyle

```



The methods return `OptionStyle` and `SlideStyle`. They represent the looks of the subscription options at the bottom and of the slides at the top.



Use the following init for `OptionStyle`:



```swift

init(backgroundColor: UIColor? = nil, textFont: UIFont? = nil,

	textColor: UIColor? = nil, accessoryType: UITableViewCellAccessoryType? = nil)

```



and for `SlideStyle`:



```swift

init(backgroundColor: UIColor? = nil, titleFont: UIFont? = nil,

	subtitleFont: UIFont? = nil, titleColor: UIColor? = nil, 

	subtitleColor: UIColor? = nil)

```



The title is customizable via the `titleFont` and `titleColor` properties.

You can also change the background dim color using the `dimColor: UIColor` and `dimView: UIView` properties.



# TODO



1. Bug fixes.

2. Add closure-based delegation API. Example:



```swift

subscriptionVC.rowTapped { idx in

	print("tapped index: \(idx)")

}

```