https://github.com/jobandtalent/CardStackController

iOS custom controller used in Jobandtalent app to present new view controllers as cards
https://github.com/jobandtalent/CardStackController

Last synced: about 1 month ago
JSON representation

iOS custom controller used in Jobandtalent app to present new view controllers as cards

• Host: GitHub
• URL: https://github.com/jobandtalent/CardStackController
• Owner: jobandtalent
• License: mit
• Archived: true
• Created: 2016-12-01T00:20:16.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2019-04-03T02:59:34.000Z (almost 6 years ago)
• Last Synced: 2024-04-24T14:15:55.137Z (9 months ago)
• Language: Swift
• Size: 5.13 MB
• Stars: 522
• Watchers: 18
• Forks: 37
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-ios-star - CardStackController - iOS custom controller used in Jobandtalent app to present new view controllers as cards. (UI / Font)
• awesome-ios - CardStackController - iOS custom controller used in Jobandtalent app to present new view controllers as cards. (UI / Font)

README

        
![](https://github.com/jobandtalent/AnimatedTextInput/blob/master/Assets/Jobandtalent%20Eng.png)

# CardStackController

iOS custom controller used in the [Jobandtalent app](https://itunes.apple.com/app/id665060895) to present new view controllers as cards.

This controller behaves very similar to `UINavigationController`, maintaining a stack of ViewControllers. The presentation of new view controllers is different though. New view controllers are presented as a new “Card” in front of the current context. The next GIFs show the control in action.

Gif from the example project supplied:

![](https://github.com/jobandtalent/CardStackController/blob/master/Assets/cards.gif?raw=true)

Gif from the Jobandtalent app:

![](https://github.com/jobandtalent/CardStackController/blob/master/Assets/cards-app.gif?raw=true)

## Installation

Use Cocoapods to install this custom control in your project.

```

pod ‘CardStackController’, '~> 0.1.0’

```

## Usage

Use the main and only public class `CardStackController` to present or stack new view controllers.

After creating and configuring `CardStackController`, present it modally (it doesn’t need to be animated). Once the controller itself is presented, you can start stacking cards by calling `stack(viewController:)` method.

Example of usage:

```swift

cardStackController.delegate = self

cardStackController.cardScaleFactor = CGFloat(firstSlider.value)

cardStackController.firstCardTopOffset = CGFloat(secondSlider.value)

cardStackController.topOffsetBetweenCards = CGFloat(thirdSlider.value)

cardStackController.verticalTranslation = CGFloat(fourthSlider.value)

cardStackController.automaticallyDismiss = false

present(cardStackController, animated: false, completion: nil)

let root = newController()

root.delegate = self

cardStackController.stack(viewController: root)

```

This control is highly customisable and contains many features, among the ones we highlight:

- The user can dismiss cards by dragging them down.

- It is possible to tune the `damping` and `frequency` values of the presenting animation to achieve all kinds of animation curves.

- It is possible to customise the top distance between cards, the amount each card gets resized, the size of each card… 

- There are many convenient methods to unstack cards: `unstackAll`, `unstackUntilRoot`, `unstackLast`, etc.

## Under the hood

`CardStackController` uses `UIKit Dynamics` to present or stack cards. It creates an attachment behaviour between a card and a fix point on the screen. To prevent the card moving sideways, there is a collision behaviour between each card and the borders of the screen. Finally, there is a DynamicItem behaviour for each card to prevent rotation (this behaviour could also be used to apply density/friction/etc to them, but we didn’t find it necessary).

CardStackController is available under the MIT license. See the LICENSE file for more info.