d-32 / dmswipecards

🃏 Tinder like card interface

Features

• Swift 3
• Custom views for the card & overlay
• Generic
• Dynamically add new cards on top or on the bottom
• Lazy view loading

Setup

pod 'DMSwipeCards'

Usage

First import the module:

import DMSwipeCards

Next create an instance of a DMSwipeCardsView:
(Element can be your custom model, or just String)

let swipeView = DMSwipeCardsView<Element>(frame: frame,
                                          viewGenerator: viewGenerator,
                                          overlayGenerator: overlayGenerator)

Views get loaded lazy, so you have to provide DMSwipeCardsView with a ViewGenerator and optionally an OverlayGenerator.

let viewGenerator: (String, CGRect) -> (UIView) = { (element: Element, frame: CGRect) -> (UIView) in
  // return a UIView here
}

let overlayGenerator: (SwipeMode, CGRect) -> (UIView) = { (mode: SwipeMode, frame: CGRect) -> (UIView) in
  // return a UIView here
}

Adding cards

To add new cards, just call the addCards method with an array of the previously defined Element:

swipeView.addCards([Element], onTop: true)

Delegate

DMSwipeCardsView has a delegate property so you can get informed when a card has been swipped. The delegate has to implement following methods:

func swipedLeft(_ object: Any)
func swipedRight(_ object: Any)
func cardTapped(_ object: Any)
func reachedEndOfStack()

The object parameter is guarenteed to have the type Element. Sadly generics don't work here.

Example

For a nice working demo sample, please take a look the Example project.
To run the example, first run pod install in the Example directory.

Credits

Loosly based on TinderSimpleSwipeCards

dmswipecards's Issues

Naming could be improved

A way to reload the cards?

Is there any way I could reload the SwipeCards such as you can reload a CollectionViewController?

Configuration

Add the possibility to configure certain things

How to set number of visible cards?

How to set number of visible cards?

How to revert to the previous card like in Tinder?

How can I add functionality to revert to the previous card ( in the event the user didn't mean to swipe and wants to return to that element ) ?

Card loaded on top are not completely on top

Already loaded n cards (2) will still be before.

Simulate swipe

Manually invoke the swipe action and simulate it

Event when a card is displayed

Hi,

I have to play a bunch of videos retrieved from the internet on cards. This is my view generator.

let viewGenerator: (Video, CGRect) -> (UIView) = { (video: Video, frame: CGRect) -> (UIView) in
      let containerView = UIView(frame: self.view.bounds)
      
      let asset = AVURLAsset(url: URL(string: video.url)!)
      asset.resourceLoader.setDelegate(self, queue: DispatchQueue.main)
      
      let player = AVPlayer(playerItem: AVPlayerItem(asset: asset))
      player.actionAtItemEnd = .none
      
      let playerLayer = AVPlayerLayer(player: player)
      playerLayer.frame = self.view.bounds
      playerLayer.backgroundColor = UIColor.clear.cgColor
      
      containerView.layer.addSublayer(playerLayer)
      
      player.play()
      return containerView
  }

Is there a way to get notified when each card is shown in the screen? A delegate method perhaps.

The reason is, it's a little different than displaying static views or images. Because view/image cards are sort of "preloaded", right? When I add video player cards in the view generator, I have to set it to play player.play() right within the generator. The problem is then all the preloaded videos also get played simultaneously.

If there's a way to get notified when each card is displayed, maybe I could make it play when that happens.

Update readme

Swift 4 compiler failure with `#selector`

To reproduce

1. Create new project in Swift 4 with Cocoapods
2. Add DMSwipeCards to Podfile and pod install
3. Compile project

There is a compiler error at:

DMSwipeCards/DMSwipeCards/Classes/DMSwipeCard.swift

Line 39 in dab78b7

let panGesture = UIPanGestureRecognizer(target: self, action: #selector(dragEvent(gesture:)))

Argument of '#selector' refers to instance method 'dragEvent(gesture:)' that is not exposed to Objective-C