Nabigeta provides simple API to declare routes for navigation. Compatible with trait environments.
Declare your routes into a file, like your AppDelegate.
import Nabigeta
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var navigation: Navigation! = nil
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
self.navigation = Navigation(traitProvider: self.window!)
self.navigation.router = { context in
switch(context) {
case is Author:
return Route(AuthorViewController.self)
case is Book:
return Route(BookViewController.self)
.present { trait in
switch(trait.horizontalClass, trait.verticalClass) {
case (.Compact, .Compact):
return PresentationPush()
default:
return PresentationModal()
}
}
}
}
}
}
class AuthorViewController : UIViewController, Navigable {
func didNavigate(to author: Author) {
print("Navigated to /(author.name) controller")
}
}
class BookViewController {
func didTapAuthor() {
self.navigate(to: self.author) // AuthorViewController is displayed!
}
}Nabigeta provides some default Presentation strategies:
- PresentationPush
- PresentationModal
- PresentationPopover
- PresentationSegue
If none of them feed your needs, you can provide your own custom presentation just by creating a class/struct implementing the PresentationStrategy protocol.
You can cancel navigation from source controller:
bookViewController.navigateBack() // come back to BookViewControllerYou can also stop navigation from destination controller:
authorViewController.navigationTerminated(status: .Canceled) // dismiss AuthorViewControllerYou can also be notified when navigations are stopped:
bookViewController
.navigate(to: self.author)
.onTerminate { status in
if status == .Canceled {
print("author controller cancelled")
}
}