Latest 1.1.7
Homepage https://github.com/phranck/CCNNavigationController
License MIT
Platforms osx 10.9, requires ARC
Authors

An macOS Navigation Controller

A Navigation Controller for macOS that acts mostly like the counterpart on iOS – UINavigationController, using the excact method naming (with some additions).

The original idea for this controller came from Heiko Dreyer’s BFNavigationController. First I forked his repo, but decided to make my own due to too many changes and additions that has been made. So, it might be possible that parts of this code looks slightly similar to his one. (-;

Installation

You can do it manually by copying all .h and .m files into your project, or you add the following line to your Podfile:

pod 'CCNNavigationController'

How to use it

There is nothing special in using CCNNavigationController. If you are familar with iOS’ UINavigationController you should get it right from the start. Unlike Heiko’s BFNavigationController there is no need to give an initial frame. Just set your rootViewController and you’re done. The rest will be handled automatically. You can also set some configuration options via the CCNNavigationControllerConfiguration object.

There are two ways to give the navigation controller its rootViewController:

1. Set the rootViewController directly during initialization of CCNNavigationController.
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {

   MyRootVC *rootVC = [[MyRootVC alloc] init];
   CCNNavigationController *navigationController = [[CCNNavigationController alloc] initWithRootViewController:rootVC];

   // you can set some configuration options
   navigationController.configuration.transition = CCNNavigationControllerTransitionToDown;
   navigationController.configuration.transitionStyle = CCNNavigationControllerTransitionStyleStack;

   // make the navigation controller the window's content view controller
   self.window.contentViewController = navigationController;

   ...
}
2. Initialize CCNNavigationController with a nil rootViewController
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {

   CCNNavigationController *navigationController = [[CCNNavigationController alloc] initWithRootViewController:nil];

   // make the navigation controller the window's content view controller
   self.window.contentViewController = navigationController;

   //  do some other stuff...

   // initialize your rootViewController and set it as navigationController's first object
   MyRootVC *rootVC = [[MyRootVC alloc] init];
   navigationController.viewControllers = @[ rootVC ];
}

CCNNavigationController-Example

Documentation

You’ll find a complete documentation on CocoaDocs.

Contribution

The code is provided as-is, and it is far off being complete or free of bugs. If you like this component feel free to support it. Make changes related to your needs, extend it or just use it in your own project. Pull-Requests and Feedbacks are very welcome. Just contact me at [email protected] or send me a ping on Twitter @TheCocoaNaut.

License

This software is published under the MIT License.

Latest podspec

{
    "name": "CCNNavigationController",
    "version": "1.1.7",
    "summary": "An Mac OS X Navigation Controller that acts mostly like the counter part on iOS - UINavigationController.",
    "homepage": "https://github.com/phranck/CCNNavigationController",
    "authors": {
        "Frank Gregor": "[email protected]"
    },
    "source": {
        "git": "https://github.com/phranck/CCNNavigationController.git",
        "tag": "1.1.7"
    },
    "source_files": "CCNNavigationController/**/*.{h,m}",
    "requires_arc": true,
    "platforms": {
        "osx": "10.9"
    },
    "license": {
        "type": "MIT"
    }
}

Pin It on Pinterest

Share This