Ecosyste.ms: Awesome

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

https://github.com/HideakiTouhara/Poi


https://github.com/HideakiTouhara/Poi

Last synced: about 1 month ago
JSON representation

Lists

README 

        
# Poi  

[![Pod version](https://badge.fury.io/co/Poi.svg)](https://badge.fury.io/co/Poi) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE) ![Swift 4.0.x](https://img.shields.io/badge/Swift-4.0.x-orange.svg)



You can use tinder UI like tableview method



![demo1](https://github.com/HideakiTouhara/Poi/blob/resources/Resources/sample_demo.gif)



## Installation

### Manual Installation

1. Use this command



```

git clone [email protected]:HideakiTouhara/Poi.git

```



2. Import Poi.xcodeproj to your project



![direct_import1](https://github.com/HideakiTouhara/Poi/blob/resources/Resources/direct_import1.jpg)



3. Add Poi.frameworkiOS to Embedded Binaries



![direct_import2](https://github.com/HideakiTouhara/Poi/blob/resources/Resources/direct_import2.jpg)



### Cocoa Pods

Please write the below code in Podfile



```

pod ‘Poi’

```

### Carthage

Write this code in your Cartfile.



```

github "HideakiTouhara/Poi"

```



and implement this command



```

carthage update

```



Add Poi.framework in /Carthage/Build/iOS/ to Embedded Binaries.



![carthage_import](https://github.com/HideakiTouhara/Poi/blob/resources/Resources/carthage_import.jpg)



## Usage

Create PoiView in storyboard or swift file



``` swift

import Poi



@IBOutlet weak var poiView: PoiView!

// Change View's class to PoiView in Attributes inspector.

```



or



``` swift

import Poi



let poiView = PoiView()

self.view.addSubView(poiView)

```



Conform to PoiViewDataSource and PoiViewDelegate



``` swift

class ViewController: UIViewController, PoiViewDataSource, PoiViewDelegate {

```



Designate delegate target.



Please put this code after setting card contents.



``` swift

poiView.dataSource = self

poiView.delegate = self

```



### PoiViewDataSource method



Set swipeable card number(required method)



``` swift

func numberOfCards(_ poi: PoiView) -> Int

```



Set swipeable card(required method)



``` swift

func poi(_ poi: PoiView, viewForCardAt index: Int) -> UIView

```



Set overlay image if right or left swiped



``` swift

func poi(_ poi: PoiView, viewForCardOverlayFor direction: SwipeDirection) -> UIImageView? {

    switch direction {

    case .right:

        return UIImageView(image: #imageLiteral(resourceName: "good"))

    case .left:

        return UIImageView(image: #imageLiteral(resourceName: "bad"))

    }

}

```



### PoiViewDelegate method



When did swipe, this method is called



``` swift

func poi(_ poi: PoiView, didSwipeCardAt: Int, in direction: SwipeDirection)

```



When last card was swiped, this method is called



``` swift

func poi(_ poi: PoiView, runOutOfCardAt: Int, in direction: SwipeDirection)

```



### Public method



Swipe current card



``` swift

func swipeCurrentCard(to direction: SwipeDirection)

```



Undo animation and go back previous card



``` swift

func undo()

```



## Example

Check the Example file!



``` swift

import UIKit

import Poi



class ViewController: UIViewController, PoiViewDataSource, PoiViewDelegate {



    @IBOutlet weak var poiView: PoiView!



    var sampleCards = [UIView]()



    override func viewDidLoad() {

        super.viewDidLoad()

        var colors = [UIColor.red, UIColor.orange]

        for i in (0..<2) {

            sampleCards.append(UIView(frame: CGRect(x: 0, y: 0, width: 240, height: 128)))

            sampleCards[i].backgroundColor = colors[i]

        }

        poiView.dataSource = self

        poiView.delegate = self

    }



    override func didReceiveMemoryWarning() {

        super.didReceiveMemoryWarning()

    }



    // MARK: PoiViewDataSource

    func numberOfCards(_ poi: PoiView) -> Int {

        return 2

    }



    func poi(_ poi: PoiView, viewForCardAt index: Int) -> UIView {

        return sampleCards[index]

    }



    func poi(_ poi: PoiView, viewForCardOverlayFor direction: SwipeDirection) -> UIImageView? {

        switch direction {

        case .right:

            return UIImageView(image: #imageLiteral(resourceName: "good"))

        case .left:

            return UIImageView(image: #imageLiteral(resourceName: "bad"))

        }

    }



    // MARK: PoiViewDelegate

    func poi(_ poi: PoiView, didSwipeCardAt: Int, in direction: SwipeDirection) {

        switch direction {

        case .left:

            print("left")

        case .right:

            print("right")

        }

    }



    func poi(_ poi: PoiView, runOutOfCardAt: Int, in direction: SwipeDirection) {

        print("last")

    }



    // MARK: IBAction

    @IBAction func OKAction(_ sender: UIButton) {

        poiView.swipeCurrentCard(to: .right)

    }



    @IBAction func undo(_ sender: UIButton) {

        poiView.undo()

    }

}

```

## Contribution

Please create issues or submit pull requests for anything.



## License

Poi is released under the MIT license.



© 2018 GitHub, Inc.