/ui-router-extras

Extras for UI-Router for AngularJS. Sticky States (a.k.a. parallel states), Deep State Redirect (for tab-like navigation), Future States (async state definition)

Primary LanguageJavaScriptMIT LicenseMIT

Addons for Angular UI-Router:

Full Website (description, API, demos): http://christopherthielen.github.io/ui-router-extras/

UI-Router is the defacto router for AngularJS.

UI-Router Extras adds additional features to help you write large modular applications.

  • Sticky State
  • Deep State Redirect
  • Future State
  • Previous State
  • And More?

Dependencies

  • required:
    • "angular": "~1.2.0"
    • "angular-ui-router": "~0.2.8"

Note: ui-router-extras test suite runs against UI-Router versions 0.2.8, 0.2.10, 0.2.12, 0.2.13 Support for older versions of ui-router is likely to disappear in the future.

Monolithic Install

  1. download the files
    1. NPM
      1. run npm install ui-router-extras --save-dev
    2. Bower (alternatively)
      1. bower install ui-router-extras --save-dev
  2. Include the files in your app
    1. ct-ui-router-extras.min.js
  3. Include the module as an angular dependency (i.e. in app.js) - ct.ui.router.extras

Modular Install

  1. download the files
    1. NPM
      1. run npm install ui-router-extras --save-dev
    2. Bower (alternatively)
      1. bower install ui-router-extras --save-dev
  2. Choose the modules you want. You must include core.
    1. core Core requirement. Adds state.$$state() decorator (undocumented)
    2. sticky Sticky states
    3. dsr Deep State Redirect
    4. future Future states
    5. previous Previous state (depends on transition)
    6. statevis D3 based State visualization as seen on the demo site (undocumented)
    7. transition Injectible transition promise (undocumented)
  3. Include the files for the modules you want into your app
    1. modular/ct-ui-router-extras.core.min.js
    2. modular/ct-ui-router-extras.sticky.min.js
    3. modular/ct-ui-router-extras.dsr.min.js
    4. modular/ct-ui-router-extras.future.min.js
    5. modular/ct-ui-router-extras.previous.min.js
    6. modular/ct-ui-router-extras.statevis.min.js
    7. modular/ct-ui-router-extras.transition.min.js
  4. Include the submodules as an angular dependency (i.e. in app.js) - e.g., ct.ui.router.extras.sticky

Development

  1. git checkout master
    1. run npm install && bower install
    2. write your code then run gulp
    3. git commit your changes

The gulpfile.js default target generates the output files into a build/ and build/modular directory. It runs all unit tests on the modular files individually, and then runs the tests against the full build file. When run on the full build file, the test suite is run once against each version of UI-Router listed above.