CardNavigation
The easiest way to turn a navigation controller into an interactive stack of cards.
Highlights
-
✅ Fully interactive and interruptible -
✅ Works seamlessly with scroll views -
✅ Supports changes in orientation -
✅ Can be used with or without storyboards -
✅ Written entirely in Swift using standard UIKit components
Example
Installation
CocoaPods
To install CardNavigation using CocoaPods, add the following line to your Podfile:
pod 'CardNavigation', '~> 1.1'
Swift Package Manager
To install CardNavigation using the Swift Package Manager, add the following value to your Package.swift:
dependencies: [
.package(url: "https://github.com/james01/CardNavigation.git", .upToNextMajor(from: "1.1.0"))
]
Usage
Getting Started
CardNavigation consists of a single class: CardNavigationController. It behaves like a standard UINavigationController.
At the top of the file where you'd like to use a CardNavigationController, import CardNavigation.
import CardNavigation
Create an instance of CardNavigationController the way you would a regular UINavigationController.
let navController = CardNavigationController(rootViewController: SomeViewController())
When you push a view controller, it will automatically be displayed as an interactive card.
navController.pushViewController(AnotherViewController(), animated: true)
Background Color
The CardNavigationController's navigationBar is transparent by default. This allows the controller's background color to show through.
You may want to change the background color to reflect the theme of your app.
navController.view.backgroundColor = .systemTeal
Card Appearance
To change the card appearance, create a custom view class.
import UIKit
class MyCardBackgroundView: UIView {
override init(frame: CGRect) {
super.init(frame: frame)
backgroundColor = .white
layer.cornerRadius = 32
layer.maskedCorners = [.layerMinXMinYCorner, .layerMaxXMinYCorner]
layer.cornerCurve = .continuous
layer.borderColor = UIColor.black.cgColor
layer.borderWidth = 4
}
required init?(coder: NSCoder) {
fatalError("init(coder:) has not been implemented")
}
}
Then, create a subclass of CardNavigationController and override the cardBackgroundViewClass property to return your custom class.
import UIKit
import CardNavigation
class MyCardNavigationController: CardNavigationController {
override var cardBackgroundViewClass: UIView.Type {
return MyCardBackgroundView.self
}
}
Author
James Randolph (@jamesrandolph01)
License
CardNavigation is released under the MIT license. See LICENSE for details.
3 Mar 30, 2022
428 Dec 16, 2022
716 Dec 29, 2022
2.6k Nov 29, 2022
3 May 19, 2022
850 Nov 17, 2022
527 Dec 15, 2022
74 Dec 13, 2022
2.9k Jan 2, 2023
753 Jan 2, 2023
5.2k Dec 31, 2022
6.8k Dec 27, 2022
589 Dec 24, 2022
713 Dec 25, 2022
49 Aug 23, 2022
246 Dec 28, 2022
84 Feb 4, 2022
596 Nov 17, 2022
47 Dec 19, 2022
74 Dec 13, 2022
6 Oct 15, 2022
1.2k Dec 19, 2022
285 Jan 3, 2023
96 Dec 18, 2022
4 Jul 29, 2022
0 Jan 15, 2022
5.2k Jan 2, 2023
428 Dec 16, 2022
4.1k Dec 14, 2022