2015-04-17 12:59:56 -04:00
|
|
|
/**
|
|
|
|
* @module
|
|
|
|
* @description
|
|
|
|
* Maps application URLs into application states, to support deep-linking and navigation.
|
|
|
|
*/
|
|
|
|
|
2015-09-21 22:58:45 -04:00
|
|
|
export {Router} from './src/router/router';
|
2016-02-09 14:12:41 -05:00
|
|
|
export {RouterOutlet} from './src/router/directives/router_outlet';
|
|
|
|
export {RouterLink} from './src/router/directives/router_link';
|
2015-09-30 08:48:58 -04:00
|
|
|
export {RouteParams, RouteData} from './src/router/instruction';
|
refactor(router): improve recognition and generation pipeline
This is a big change. @matsko also deserves much of the credit for the implementation.
Previously, `ComponentInstruction`s held all the state for async components.
Now, we introduce several subclasses for `Instruction` to describe each type of navigation.
BREAKING CHANGE:
Redirects now use the Link DSL syntax. Before:
```
@RouteConfig([
{ path: '/foo', redirectTo: '/bar' },
{ path: '/bar', component: BarCmp }
])
```
After:
```
@RouteConfig([
{ path: '/foo', redirectTo: ['Bar'] },
{ path: '/bar', component: BarCmp, name: 'Bar' }
])
```
BREAKING CHANGE:
This also introduces `useAsDefault` in the RouteConfig, which makes cases like lazy-loading
and encapsulating large routes with sub-routes easier.
Previously, you could use `redirectTo` like this to expand a URL like `/tab` to `/tab/posts`:
@RouteConfig([
{ path: '/tab', redirectTo: '/tab/users' }
{ path: '/tab', component: TabsCmp, name: 'Tab' }
])
AppCmp { ... }
Now the recommended way to handle this is case is to use `useAsDefault` like so:
```
@RouteConfig([
{ path: '/tab', component: TabsCmp, name: 'Tab' }
])
AppCmp { ... }
@RouteConfig([
{ path: '/posts', component: PostsCmp, useAsDefault: true, name: 'Posts' },
{ path: '/users', component: UsersCmp, name: 'Users' }
])
TabsCmp { ... }
```
In the above example, you can write just `['/Tab']` and the route `Users` is automatically selected as a child route.
Closes #4728
Closes #4228
Closes #4170
Closes #4490
Closes #4694
Closes #5200
Closes #5475
2015-11-23 21:07:37 -05:00
|
|
|
export {RouteRegistry, ROUTER_PRIMARY_COMPONENT} from './src/router/route_registry';
|
2016-02-09 14:12:41 -05:00
|
|
|
export * from './src/router/route_config/route_config_decorator';
|
2015-08-04 18:08:59 -04:00
|
|
|
export * from './src/router/route_definition';
|
2015-07-13 19:13:20 -04:00
|
|
|
export {OnActivate, OnDeactivate, OnReuse, CanDeactivate, CanReuse} from './src/router/interfaces';
|
2016-02-09 14:12:41 -05:00
|
|
|
export {CanActivate} from './src/router/lifecycle/lifecycle_annotations';
|
2015-07-17 16:36:53 -04:00
|
|
|
export {Instruction, ComponentInstruction} from './src/router/instruction';
|
2015-11-23 13:18:04 -05:00
|
|
|
export {OpaqueToken} from 'angular2/core';
|
2016-01-21 12:58:28 -05:00
|
|
|
export {ROUTER_PROVIDERS_COMMON} from 'angular2/src/router/router_providers_common';
|
|
|
|
export {ROUTER_PROVIDERS, ROUTER_BINDINGS} from 'angular2/src/router/router_providers';
|
2015-05-01 08:53:58 -04:00
|
|
|
|
2016-02-09 14:12:41 -05:00
|
|
|
import {RouterOutlet} from './src/router/directives/router_outlet';
|
|
|
|
import {RouterLink} from './src/router/directives/router_link';
|
2015-11-06 20:34:07 -05:00
|
|
|
import {CONST_EXPR} from './src/facade/lang';
|
2015-10-09 19:22:07 -04:00
|
|
|
|
2015-09-03 19:17:23 -04:00
|
|
|
/**
|
2015-09-21 20:17:25 -04:00
|
|
|
* A list of directives. To use the router directives like {@link RouterOutlet} and
|
|
|
|
* {@link RouterLink}, add this to your `directives` array in the {@link View} decorator of your
|
|
|
|
* component.
|
2015-09-03 19:17:23 -04:00
|
|
|
*
|
2015-10-19 10:37:32 -04:00
|
|
|
* ### Example ([live demo](http://plnkr.co/edit/iRUP8B5OUbxCWQ3AcIDm))
|
2015-09-21 20:17:25 -04:00
|
|
|
*
|
|
|
|
* ```
|
2015-12-11 18:01:37 -05:00
|
|
|
* import {Component} from 'angular2/core';
|
2015-10-11 01:11:13 -04:00
|
|
|
* import {ROUTER_DIRECTIVES, ROUTER_PROVIDERS, RouteConfig} from 'angular2/router';
|
2015-09-03 19:17:23 -04:00
|
|
|
*
|
2015-10-11 10:41:19 -04:00
|
|
|
* @Component({directives: [ROUTER_DIRECTIVES]})
|
2015-09-03 19:17:23 -04:00
|
|
|
* @RouteConfig([
|
2015-09-21 20:17:25 -04:00
|
|
|
* {...},
|
2015-09-03 19:17:23 -04:00
|
|
|
* ])
|
|
|
|
* class AppCmp {
|
|
|
|
* // ...
|
|
|
|
* }
|
|
|
|
*
|
2015-10-11 01:11:13 -04:00
|
|
|
* bootstrap(AppCmp, [ROUTER_PROVIDERS]);
|
2015-09-03 19:17:23 -04:00
|
|
|
* ```
|
|
|
|
*/
|
2015-09-21 20:17:25 -04:00
|
|
|
export const ROUTER_DIRECTIVES: any[] = CONST_EXPR([RouterOutlet, RouterLink]);
|