Awesome
angular-mobile-nav
Demo (Only will work in webkit browsers)
Download (.zip)
A simple navigation service and directive which will transition between partials. Intended for mobile applications on Android/iOS.
Licensed with MIT License.
State of this Project (as of July 2013)
- I will add no new features to this - only continue to maintain it.
- I recommend a solution like Ionic Framework for a full-scale mobile application solution.
- angular-mobile-nav is a good solution for a minimal mobile angularjs navigation library, with no frills or addons.
- However, it could be done much simpler post angular-1.2.x, using ng-view, ng-animate, and some locationChangeSuccess listening to detect back.
- If you want to fix bugs with this, please email me and ask and I may make you a collaborator.
Usage
-
Requires AngularJS 1.1.4+
-
Include
mobile-nav.js
andmobile-nav.css
into your page -
Declare
'mobile-navigate'
as a dependency for your angular app:angular.module('myApp', ['ajoslin.mobile-navigate']);
-
Setup your routes as normal with
$routeProvider
. -
Use the
$navigate
service to do your transitions, instead of<a>
links. Use$navigate.go('/path')
, and$navigate.back()
. -
You can erase history (eg when switching tabs) with
$navigate.eraseHistory()
-
You can add transition classes of your own (check out the css file for how the current ones are done). There are three presets available:
slide
,modal
, andnone
. Use them in thego
function, eg$navigate.go('/path', 'modal')
. -
Use the
<mobile-view>
element instead of the normal<ng-view>
.
Development
- To use the Makefile, install jshint and uglifyjs with
npm install -g jshint uglify-js
. - If you are on windows and can't use a Makefile, there's nothing else at the moment.
- To get the demo to work, you first have to run
make
, then open the demo atdist/index.html
. - When pushing a new build, go to the gh-pages branch and move the contents dist folder up one level (
mv dist/* .
)
Improving Phonegap Performance on Android
See this wiki article by @ArtworkAD.