Official website: router5.github.io
A simple, powerful, modular and extensible router, organising your named routes in a tree and handling route transitions. In its simplest form, Router5 processes routing instructions and outputs state updates.
Router5 is library and framework agnostic, and makes no asumption on your implementation. It favours convention over configuration, by giving you the means to observe route changes and to react to them. Afterall, why treat route changes any different than data changes?
To get started, look here: Understanding router5 and Get started.
- Use of hash (#)
- Default start route: a default route to navigate to on load if the current URL doesn't match any route. Similar to
$routeProvider.otherwise()in Angular ngRoute module. - Start and stop
- Nested named routes: routes are identified by names and path (containing parameters) so you don't have to manipulate URLs, even query parameters don't need to be specified on leaves only. directly. Routes can be nested, introducing the notion of route segments.
- Segments activation: you can control whether or not a route can be accessed by specifying a
canActivatefunction per node. Supports asynchronous results. - Segments deactivation: you can register segment components. On a route change, it will ask those components through their
canDeactivatemethod if they allow navigation. Similar to Angular 2 and Aurelia routers. Supports asynchronous results. - Custom plugins: extend your router behaviour with custom plugins
- Middleware functions: handle any data updates or other asynchronous actions with multiplebefore updating your view.
- Universal applications: use on client and server side
- Redirections: redirect to another route on error
- You are in control! You decide what to do on a route change and how to do it.
- router5-listeners: allows you to add route change and node listenerns. Node listeners are triggered if that named route node is the node a component tree needs to be re-rendered from.
- router5-history: updates your browser URL and state using HTML5 history API and listens to popstate events. Supports use of hash in URL, but session history is still required: deciding to use a hash or not is therefore not a decision based on browser support, but rather a decision based on server capabilities!
- router5-persistent-params: allows some query parameters to persist and survive navigation, without having to manually specify them for each transition.
- Configuring routes
- Router options
- Path syntax
- Navigation
- Preventing navigation
- Custom errors and redirections
- Middleware functions
- Transition
- Using plugins
- Universal applications
- Async data
- react-router5
- redux-router5
- deku-router5
- router5-link-interceptor
- cycle-router5 (work in progress, not released)
Please read contributing guidelines.