routie 0,0 grunt npm

a tiny javascript hash router

3 years after MIT

Routie

Routie is a javascript hash routing library. It is designed for scenarios when push state is not an option (IE8 support, static/Github pages, Phonegap, simple sites, etc). It is very tiny (800 bytes gzipped), and should be able to handle all your routing needs.

Download

Basic Usage

There are three ways to call routie:

Here is the most basic way:

routie('users', function() {
    //this gets called when hash == #users
});

If you want to define multiple routes you can pass in an object like this:

routie({
    'users': function() {

    },
    'about': function() {
    }
});

If you want to trigger a route manually, you can call routie like this:

routie('users/bob');  //window.location.hash will be #users/bob

Regex Routes

Routie also supports regex style routes, so you can do advanced routing like this:

routie('users/:name', function(name) {
    console.log(name);
});
routie('users/bob'); // logs `'bob'`

Optional Params:

routie('users/:name?', function(name) {
    console.log(name);
});
routie('users/'); // logs `undefined`
routie('users/bob'); // logs `'bob'`

Wildcard:

routie('users/*', function() {
});
routie('users/12312312');

Catch All:

routie('*', function() {
});
routie('anything');

Named Routes

Named routes make it easy to build urls for use in your templates. Instead of re-creating the url, you can just name your url when you define it and then perform a lookup. The name of the route is optional. The syntax is "[name] [route]".

routie('user users/:name', function() {});

then in your template code, you can do:

routie.lookup('user', { name: 'bob'}) // == users/bob

Dependencies

None

Supports

Any modern browser and IE8+

Tests

Run make install, then make test, then go to http://localhost:8000/test

Related Repositories

frontend-tools

frontend-tools

Landscaping With Front-end Tools ...

aula

aula

Aula.io - The best of tech talks in one place ...

frontend-tools

frontend-tools

Landscaping With Front-end Tools ...

frontend-tools

frontend-tools

Landscaping With Front-end Tools ...

gh-info

gh-info

Get info about your repo. ...


Top Contributors

jgallen23 CtrlC-Root daniloprates nairvijays alexeyraspopov DavidSouther danschumann

Dependencies

package version
dev assert ~1.3.0
mocha ~1.9.0
grunt ~0.4.1
grunt-reloadr ~0.1.2
grunt-mocha ~0.3.0
grunt-contrib-concat ~0.3.0
grunt-contrib-uglify ~0.2.0
grunt-contrib-jshint ~0.4.3
grunt-contrib-connect ~0.3.0
grunt-contrib-watch ~0.3.1
grunt-plato ~0.2.0

Releases

-   0.3.2 zip tar
-   0.3.1 zip tar
-   0.3.0 zip tar
-   0.2.3 zip tar
-   0.2.2 zip tar
-   0.2.1 zip tar
-   0.2.0 zip tar
-   0.1.1 zip tar
-   0.1.0 zip tar
-   0.0.1 zip tar