angular-cn/modules/angular2/docs/cheatsheet/routing.md

2.9 KiB

@cheatsheetSection Routing and navigation @cheatsheetIndex 10 @description {@target js ts}import {RouteConfig, ROUTER_DIRECTIVES, ROUTER_PROVIDERS, ...} from 'angular2/router';{@endtarget} {@target dart}import 'package:angular2/angular2.dart';{@endtarget}

@cheatsheetItem syntax(js ts): @RouteConfig([ { path: '/:myParam', component: MyComponent, as: 'MyCmp' }, { path: '/staticPath', component: ..., as: ...}, { path: '/*wildCardParam', component: ..., as: ...} ]) class MyComponent() {}|@RouteConfig syntax(dart): @RouteConfig(const [ const Route(path: '/:myParam', component: MyComponent, name: 'MyCmp' ), ]) description: Configures routes for the decorated component. Supports static, parameterized and wildcard routes.

@cheatsheetItem syntax: <router-outlet></router-outlet>|router-outlet description: Marks the location to load the component of the active route.

@cheatsheetItem <a [routerLink]="[ '/MyCmp', {myParam: 'value' } ]">|[routerLink] description: Creates a link to a different view based on a route instruction consisting of a route name and optional parameters. The route name matches the as property of a configured route. Add the '/' prefix to navigate to a root route; add the './' prefix for a child route.

@cheatsheetItem syntax(js ts): @CanActivate(() => { ... })class MyComponent() {}|@CanActivate syntax(dart): @CanActivate(() => ...)class MyComponent() {}|@CanActivate description: A component decorator defining a function that the router should call first to determine if it should activate this component. Should return a boolean or a promise.

@cheatsheetItem syntax: routerOnActivate(nextInstruction, prevInstruction) { ... }|routerOnActivate description: After navigating to a component, the router calls component's routerOnActivate method (if defined).

@cheatsheetItem syntax: routerCanReuse(nextInstruction, prevInstruction) { ... }|routerCanReuse description: The router calls a component's routerCanReuse method (if defined) to determine whether to reuse the instance or destroy it and create a new instance. Should return a boolean or a promise.

@cheatsheetItem syntax: routerOnReuse(nextInstruction, prevInstruction) { ... }|routerOnReuse description: The router calls the component's routerOnReuse method (if defined) when it re-uses a component instance.

@cheatsheetItem syntax: routerCanDeactivate(nextInstruction, prevInstruction) { ... }|routerCanDeactivate description: The router calls the routerCanDeactivate methods (if defined) of every component that would be removed after a navigation. The navigation proceeds if and only if all such methods return true or a promise that is resolved.

@cheatsheetItem syntax: routerOnDeactivate(nextInstruction, prevInstruction) { ... }|routerOnDeactivate description: Called before the directive is removed as the result of a route change. May return a promise that pauses removing the directive until the promise resolves.