2015-04-17 09:59:56 -07:00
|
|
|
/**
|
|
|
|
* @module
|
|
|
|
* @description
|
|
|
|
* Maps application URLs into application states, to support deep-linking and navigation.
|
|
|
|
*/
|
|
|
|
|
2015-09-21 19:58:45 -07:00
|
|
|
export {Router} from './src/router/router';
|
2015-04-17 09:59:56 -07:00
|
|
|
export {RouterOutlet} from './src/router/router_outlet';
|
|
|
|
export {RouterLink} from './src/router/router_link';
|
2015-09-30 14:48:58 +02:00
|
|
|
export {RouteParams, RouteData} from './src/router/instruction';
|
2015-11-23 10:47:06 -08:00
|
|
|
export {PlatformLocation} from './src/router/platform_location';
|
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 18:07:37 -08:00
|
|
|
export {RouteRegistry, ROUTER_PRIMARY_COMPONENT} from './src/router/route_registry';
|
2015-11-17 10:47:59 -08:00
|
|
|
export {LocationStrategy, APP_BASE_HREF} from './src/router/location_strategy';
|
2015-06-15 14:34:14 -07:00
|
|
|
export {HashLocationStrategy} from './src/router/hash_location_strategy';
|
2015-08-24 12:13:51 -07:00
|
|
|
export {PathLocationStrategy} from './src/router/path_location_strategy';
|
2015-11-17 10:47:59 -08:00
|
|
|
export {Location} from './src/router/location';
|
2015-05-04 17:57:28 -07:00
|
|
|
export * from './src/router/route_config_decorator';
|
2015-08-04 15:08:59 -07:00
|
|
|
export * from './src/router/route_definition';
|
2015-07-13 16:13:20 -07:00
|
|
|
export {OnActivate, OnDeactivate, OnReuse, CanDeactivate, CanReuse} from './src/router/interfaces';
|
|
|
|
export {CanActivate} from './src/router/lifecycle_annotations';
|
2015-07-17 13:36:53 -07:00
|
|
|
export {Instruction, ComponentInstruction} from './src/router/instruction';
|
2015-11-23 10:18:04 -08:00
|
|
|
export {OpaqueToken} from 'angular2/core';
|
2016-01-21 09:58:28 -08: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 05:53:58 -07:00
|
|
|
|
2015-05-21 16:38:43 -07:00
|
|
|
import {RouterOutlet} from './src/router/router_outlet';
|
|
|
|
import {RouterLink} from './src/router/router_link';
|
2015-11-06 17:34:07 -08:00
|
|
|
import {CONST_EXPR} from './src/facade/lang';
|
2015-10-09 16:22:07 -07:00
|
|
|
|
2015-09-03 16:17:23 -07:00
|
|
|
/**
|
2015-09-21 17:17:25 -07: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 16:17:23 -07:00
|
|
|
*
|
2015-10-19 15:37:32 +01:00
|
|
|
* ### Example ([live demo](http://plnkr.co/edit/iRUP8B5OUbxCWQ3AcIDm))
|
2015-09-21 17:17:25 -07:00
|
|
|
*
|
|
|
|
* ```
|
2015-12-11 15:01:37 -08:00
|
|
|
* import {Component} from 'angular2/core';
|
2015-10-10 22:11:13 -07:00
|
|
|
* import {ROUTER_DIRECTIVES, ROUTER_PROVIDERS, RouteConfig} from 'angular2/router';
|
2015-09-03 16:17:23 -07:00
|
|
|
*
|
2015-10-11 07:41:19 -07:00
|
|
|
* @Component({directives: [ROUTER_DIRECTIVES]})
|
2015-09-03 16:17:23 -07:00
|
|
|
* @RouteConfig([
|
2015-09-21 17:17:25 -07:00
|
|
|
* {...},
|
2015-09-03 16:17:23 -07:00
|
|
|
* ])
|
|
|
|
* class AppCmp {
|
|
|
|
* // ...
|
|
|
|
* }
|
|
|
|
*
|
2015-10-10 22:11:13 -07:00
|
|
|
* bootstrap(AppCmp, [ROUTER_PROVIDERS]);
|
2015-09-03 16:17:23 -07:00
|
|
|
* ```
|
|
|
|
*/
|
2015-09-21 17:17:25 -07:00
|
|
|
export const ROUTER_DIRECTIVES: any[] = CONST_EXPR([RouterOutlet, RouterLink]);
|