@angular/router

package

Implements the Angular Router service , which enables navigation from one view to the next as users perform application tasks.

Defines the Route object that maps a URL path to a component, and the RouterOutlet directive that you use to place a routed view in a template, as well as a complete API for configuring, querying, and controlling the router state.

Import RouterModule to use the Router service in your app. For more usage information, see the Routing and Navigation guide.

Entry points

Primary

@angular/router

Implements the Angular Router service , which enables navigation from one view to the next as users perform application tasks.

Secondary

`@angular/router/testing`	Supplies a testing module for the Angular `Router` subsystem.
`@angular/router/upgrade`	Provides support for upgrading routing applications from Angular JS to Angular.

Primary entry point exports

NgModules

RouterModule

Adds router directives and providers.

Classes

`ActivationEnd`	An event triggered at the end of the activation part of the Resolve phase of routing.
`ActivationStart`	An event triggered at the start of the activation part of the Resolve phase of routing.
`ChildActivationEnd`	An event triggered at the end of the child-activation part of the Resolve phase of routing.
`ChildActivationStart`	An event triggered at the start of the child-activation part of the Resolve phase of routing.
`ChildrenOutletContexts`	Store contextual information about the children (= nested) `RouterOutlet`
`DefaultUrlSerializer`	A default implementation of the `UrlSerializer`.
`GuardsCheckEnd`	An event triggered at the end of the Guard phase of routing.
`GuardsCheckStart`	An event triggered at the start of the Guard phase of routing.
`NavigationCancel`	An event triggered when a navigation is canceled, directly or indirectly.
`NavigationEnd`	An event triggered when a navigation ends successfully.
`NavigationError`	An event triggered when a navigation fails due to an unexpected error.
`NavigationStart`	An event triggered when a navigation starts.
`NoPreloading`	Provides a preloading strategy that does not preload any modules.
`OutletContext`	Store contextual information about a `RouterOutlet`
`PreloadAllModules`	Provides a preloading strategy that preloads all modules as quickly as possible.
`PreloadingStrategy`	Provides a preloading strategy.
`ResolveEnd`	An event triggered at the end of the Resolve phase of routing.
`ResolveStart`	An event triggered at the the start of the Resolve phase of routing.
`RouteConfigLoadEnd`	An event triggered when a route has been lazy loaded.
`RouteConfigLoadStart`	An event triggered before lazy loading a route configuration.
`RouteReuseStrategy`	Provides a way to customize when activated routes get reused.
`Router`	A service that provides navigation and URL manipulation capabilities.
`RouterEvent`	Base for events the router goes through, as opposed to events tied to a specific route. Fired one time for any given navigation.
`RouterPreloader`	The preloader optimistically loads all router configurations to make navigations into lazily-loaded sections of the application faster.
`RoutesRecognized`	An event triggered when routes are recognized.
`Scroll`	An event triggered by scrolling.
`UrlHandlingStrategy`	Provides a way to migrate AngularJS applications to Angular.
`UrlSegment`	Represents a single URL segment.
`UrlSegmentGroup`	Represents the parsed URL segment group.
`UrlSerializer`	Serializes and deserializes a URL string into a URL tree.

Functions

`convertToParamMap`	Converts a `Params` instance to a `ParamMap`.
`provideRoutes`	Registers a DI provider for a set of routes.

Structures

`ActivatedRoute`	Provides access to information about a route associated with a component that is loaded in an outlet. Use to traverse the `RouterState` tree and extract information from nodes.
`ActivatedRouteSnapshot`	Contains the information about a route associated with a component loaded in an outlet at a particular moment in time. ActivatedRouteSnapshot can also be used to traverse the router state tree.
`CanActivate`	Interface that a class can implement to be a guard deciding if a route can be activated. If all guards return `true`, navigation will continue. If any guard returns `false`, navigation will be cancelled. If any guard returns a `UrlTree`, current navigation will be cancelled and a new navigation will be kicked off to the `UrlTree` returned from the guard.
`CanActivateChild`	Interface that a class can implement to be a guard deciding if a child route can be activated. If all guards return `true`, navigation will continue. If any guard returns `false`, navigation will be cancelled. If any guard returns a `UrlTree`, current navigation will be cancelled and a new navigation will be kicked off to the `UrlTree` returned from the guard.
`CanDeactivate`	Interface that a class can implement to be a guard deciding if a route can be deactivated. If all guards return `true`, navigation will continue. If any guard returns `false`, navigation will be cancelled. If any guard returns a `UrlTree`, current navigation will be cancelled and a new navigation will be kicked off to the `UrlTree` returned from the guard.
`CanLoad`	Interface that a class can implement to be a guard deciding if children can be loaded.
`ExtraOptions`	A set of configuration options for a router module, provided in the `forRoot()` method.
`NavigationExtras`	Options that modify the navigation strategy.
`ParamMap`	A map that provides access to the required and optional parameters specific to a route. The map supports retrieving a single value with `get()` or multiple values with `getAll()`.
`Resolve`	Interface that classes can implement to be a data provider. A data provider class can be used with the router to resolve data during navigation. The interface defines a `resolve()` method that will be invoked when the navigation starts. The router will then wait for the data to be resolved before the route is finally activated.
`Route`	A configuration object that defines a single route. A set of routes are collected in a `Routes` array to define a `Router` configuration. The router attempts to match segments of a given URL against each route, using the configuration options defined in this object.
`RouterState`	Represents the state of the router as a tree of activated routes.
`RouterStateSnapshot`	Represents the state of the router at a moment in time.
`UrlTree`	Represents the parsed URL.

Directives

`RouterLink`	Lets you link to specific routes in your app.
`RouterLinkActive`	Lets you add a CSS class to an element when the link's route becomes active.
`RouterLinkWithHref`	Lets you link to specific routes in your app.
`RouterOutlet`	Acts as a placeholder that Angular dynamically fills based on the current router state.

Types

`Data`	Represents static data associated with a particular route.
`DeprecatedLoadChildren`	Deprecated: the `string` form of `loadChildren` is deprecated in favor of the proposed ES dynamic `import()` expression, which offers a more natural and standards-based mechanism to dynamically load an ES module at runtime. A string of the form `path/to/file#exportName` that acts as a URL for a set of routes to load.
`DetachedRouteHandle`	Represents the detached route tree.
`Event`	Router events that allow you to track the lifecycle of the router.
`InitialNavigation`	Allowed values in an `ExtraOptions` object that configure when the router performs the initial navigation operation.
`LoadChildren`	A string of the form `path/to/file#exportName` that acts as a URL for a set of routes to load, or a function that returns such a set.
`LoadChildrenCallback`	A function that is called to resolve a collection of lazy-loaded routes.
`Navigation`	Information about a navigation operation. Retrieve the most recent navigation object with the `router.getCurrentNavigation()` method.
`PRIMARY_OUTLET`	The primary routing outlet.
`Params`	A collection of matrix and query URL parameters.
`QueryParamsHandling`	How to handle query parameters in a router link. One of: `merge` : Merge new with current parameters. `preserve` : Preserve current parameters.
`ROUTER_CONFIGURATION`	A DI token for the router service.
`ROUTER_INITIALIZER`	A DI token for the router initializer that is called after the app is bootstrapped.
`ROUTES`	The DI token for a router configuration.
`ResolveData`	Represents the resolved data associated with a particular route.
`Routes`	Represents a route configuration for the Router service. An array of `Route` objects, used in `Router.config` and for nested route configurations in `Route.children`.
`RunGuardsAndResolvers`	A policy for when to run guards and resolvers on a route.
`UrlMatchResult`	Represents the result of matching URLs with a custom matching function.
`UrlMatcher`	A function for matching a route against URLs. Implement a custom URL matcher for `Route.matcher` when a combination of `path` and `pathMatch` is not expressive enough. Cannot be used together with `path` and `pathMatch`.