FRLayeredNavigationController, an iOS container view controller with an API similar to UINavigationController. Influenced by the UI of the Twitter and Soundcloud iPad apps, the user will think of a stack of paper and has similar interaction options.
Official Project Home: https://github.com/weissi/FRLayeredNavigationController . You can also find FRLayeredNavigationController at Ohloh.
See below for documentation and instructions (including a screencast) on how to add FRLayeredNavigationController to your project.
If you have further questions, feel free to mail me!
- The API
feels very natural to iOS developers since it's very similar to the API of
- FRLayeredNavigationController uses ARC (automatic reference counting) but you can use it in your legacy projects without ARC, too
- Low memory conditions and rotation are handled correctly with FRLayeredNavigationController
- FRLayeredNavigationController works on the iPad, the iPhone and iPod touch but the UI concept is best on the iPad since the big screen
- You can easily install FRLayeredNavigationController using CocoaPods or manually (screencast and instructions below)
- Correctly handles
view.boundsand has therefore no problems with
view.transform(such as rotations) as you can see on this screenshot.
- App Store compatible (uses only Public API and was already approved by Apple)
- iOS 7 & 8 Support (still supports iOS6 and older with old visuals)
It's all open source but you can use it in your commercial product free of charge. FRLayeredNavigationController is licensed under the terms of the Modified BSD License.
Adding FRLayeredNavigationController to your project
FRLayeredNavigationController is compiled as static libraries. It use Xcode's
"dependent project" facilities. If you're familiar with
CocoaPods use that, just add the
dependency 'FRLayeredNavigationController' to your
Here is how: Estimated time: 5 minutes.
There's also a screencast which shows how to add FRLayeredNavigationController to a project and how to switch from UINavigationController to FRLayeredNavigationController: http://youtu.be/k9bFAYtoenw .
Clone the FRLayeredNavigationController git repository:
git clone firstname.lastname@example.org:weissi/FRLayeredNavigationController.git. Make sure you store the repository in a permanent place because Xcode will need to reference the files every time you compile your project.
Locate the "FRLayeredNavigationController.xcodeproj" file under "
FRLayeredNavigationController". Drag FRLayeredNavigationController.xcodeproj and drop it onto the root of your Xcode project's "Groups and Files" sidebar.
Now you need to link the FRLayeredNavigationController static libraries to your project. Add
Link Binary With Librariessection of your project's Build phases.
Finally, we need to tell your project where to find the FRLayeredNavigationController headers. Open your "Project Settings" and go to the "Build" tab. Look for "Header Search Paths" and double-click it. Add the relative path from your project's directory to the "FRLayeredNavigationController/" directory.
While you are in Project Settings, go to "Other Linker Flags" under the "Linker" section, and add "
-fobjc-arc" and "
-all_load" to the list of flags.
You're ready to go. Just
#import "FRLayeredNavigationController/FRLayeredNavigation.h"anywhere you want to use FRLayeredNavigationController in your project.
If you want to, you can install appledoc
appledoc . in FRLayeredNavigationController's root directory to
install the API documentation in Xcode.