CardViewList 1.1.8

Maintained by icaksama.

You want to add pod 'CardViewList', '~> 1.1' similar to the following to your Podfile:

target 'MyApp' do
  pod 'CardViewList', '~> 1.1'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try CardViewList

CardViewList 1.1.8

By
icaksama
icaksama

CardViewList (Swift 4)

Create CardView like Android easier on iOS. Support iOS 8.0 - above!

Now, You can create CardView list like Android in iOS with simple way. This library provides the list for horizontal and vertical scroll and the dynamic control such as tableView in iOS. Easy to understand because of the concept similar to TableViewDelegete. You can create CardView list with your UIViewControllers or UIViews.
CardViewList have many feature for make your CardView awesome like animation scroll, clickable, multi-touch and responsive. It's Awesome!

Add to Podfile

Add CardViewList library to your Podfile and install.

pod 'CardViewList', '~> 1.1.8'

Import Library

Add import CardViewList library in your class before use this library.

import CardViewList

Add Delegete

Add CardViewListDelegete in your UIViewController

class ViewController: UIViewController, CardViewListDelegete {

Add Method Delegete

Method delegete is optional. But you can add them to your code for detecting some condition for your programs. Please define the method depend on CardView from UIView/UIViewController.

// Response when CardView will Display.
func cardView(willDisplay scrollView: UIScrollView, identifierCards identifier: String) {}

// Response when every single of CardView from UIView will attach.
func cardView(_ scrollView: UIScrollView, willAttachCardView cardView: UIView, identifierCards identifier: String, index: Int) {}

// Response when every single of CardView from UIViewController will attach.
func cardView(_ scrollView: UIScrollView, willAttachCardViewController cardViewController: UIViewController, identifierCards identifier: String, index: Int) {}

// Response when CardView from UIView did finish attached.
func cardView(_ scrollView: UIScrollView, didFinishDisplayCardViews cardViews: [UIView], identifierCards identifier: String) {}

// Response when CardView from UIViewController did finish attached.
func cardView(_ scrollView: UIScrollView, didFinishDisplayCardViewControllers cardViewsController: [UIViewController], identifierCards identifier: String) {}

// Response when CardView is selected.
func cardView(_ scrollView: UIScrollView, didSelectCardView cardView: UIView, identifierCards identifier: String, index: Int) {}

Create CardView List with UIViewControler

First, You need to create your UIViewControler as CardView. You can see the demo project.
Make sure run this program inside viewDidAppear for best appearance. "identifier" will let you create more than one CardView list in one page and detect it with the identifier.

fileprivate var cardViewList: CardViewList!
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    self.cardViewList = CardViewList()
    self.cardViewList.delegete = self
    
    // Create CardView List from UIViewController
    var cardViewControllers1 = [UIViewController]()
    for _ in 1 ... 25 {
        cardViewControllers1.append(CardTwoViewController(nibName: "CardTwoViewController", bundle: nil))
    }
    self.cardViewList.animationScroll = .transformToBottom
    self.cardViewList.isClickable = true
    self.cardViewList.clickAnimation = .bounce
    self.cardViewList.grid = 1
    self.cardViewList.generateCardViewList(containerView: cardContainerHorizontal, viewControllers: cardViewControllers1, listType: .horizontal, identifier: "horizontalCard")
    //------------------------ - - ----------------------
}

Create CardView List with UIView

First, You need to create your Views as CardView. You can see in the demo project.
Make sure run this program inside viewDidAppear for best appearance. "identifier" will let you create more than one CardView list in one page and detect it with the identifier.

fileprivate var cardViewList: CardViewList!
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    self.cardViewList = CardViewList()
    self.cardViewList.delegete = self
    
    // Create CardView List from UIView
    var cardViews1 = [UIView]()
    for _ in 1 ... 25 {
    let cardView = CardView(frame: CGRect(x: 0, y: 0, width: 150, height: 150))
    cardViews1.append(cardView)
    }
    self.cardViewList.animationScroll = .scaleBounce
    self.cardViewList.isClickable = true
    self.cardViewList.clickAnimation = .bounce
    self.cardViewList.cardSizeType = .autoSize
    self.cardViewList.grid = 1
    self.cardViewList.generateCardViewList(containerView: cardContainerWithView, views: cardViews1, listType: .vertical, identifier: "CardWithUIViews1")
    //------------------------ - - ----------------------
}

CardView Setting

Setting the CardView before generate CardView List.

fileprivate var cardViewList: CardViewList!
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    self.cardViewList = CardViewList()

    /** Set disable/enable shadow of CardView. Default is true */
    open var isShadowEnable: Bool = true
    
    /** Set disable/enable click of CardView. Default is false */
    open var isClickable: Bool = false
    
    /** Set multiple touch of CardView. Default is false */
    open var isMultipleTouch: Bool = false
    
    /** Set corner radius of card view in pixel. Default is 12.0 */
    open var cornerRadius: CGFloat = 12.0
    
    /** Set shadow size of card view in pixel. Default is 5.0 */
    open var shadowSize: CGFloat = 5.0
    
    /** Set shadow opacity of card view in 0 - 1. Default is 0.9 */
    open var shadowOpacity: Float = 0.9
    
    /** Set shadow color of card view. Default color is black */
    open var shadowColor: UIColor = UIColor.black
    
    /** Set CardView margin in percent(%) of containerView. Default is 5 */
    open var margin: CGFloat = 5
    
    /** Set margin between CardView in percent(%) of containerView. Default is 5 */
    open var marginCards: CGFloat = 5
    
    /** Set list type horizontal, vertical, horizontalVertical. Default is vertical */
    open var listType: ListType = .vertical
    
    /** Set grid List of CardView. Default is 1 */
    open var grid: Int = 1
    
    /** Set size of CardView. Default is autoSize */
    open var cardSizeType: CardSizeType = .autoSize
    
    /** Set max width of CardView in percent(%) of containerView. Default is 100 */
    open var maxWidth: CGFloat = 100
    
    /** Set max height of CardView in percent(%) of containerView. Default is 100 */
    open var maxHeight: CGFloat = 100
    
    /** Set animation when CardView showing. Default is none */
    open var animationScroll: AnimationOpening = .none
    
    /** Set animation click for CardView. Default is none */
    open var clickAnimation: ClickAnimation = .none
    
    /** Set the delegete of CardViewList */
    open var delegete: CardViewListDelegete!

    var cardViews = [UIView]()
    for _ in 1 ... 25 {
        let cardView = CardView(frame: CGRect(x: 0, y: 0, width: 150, height: 150))
        cardViews1.append(cardView)
    }
    self.cardViewList.generateCardViewList(containerView: cardContainerWithView, views: cardViews, listType: .horizontal, identifier: "CardWithUIViews1")
}

List of AnimationScroll Types

There are many animation scrolls. You can use them for your CardView list. The animation will start when CardView is visible to the user when scrolling.

- none
- scaleBounce
- transformToRight
- transformToLeft
- transformToBottom
- transformToTop

List of CardSize Types

There are three CardSize type.

- autoSize : CardView size will generated from library.
- square   : CardView size will be generated to square shape depend by width or height containerView that lower.
- circle   : CardView size will be generated to square circle depend by width or height containerView that lower.

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.