UNPKG

angular2

Version:

Angular 2 - a web framework for modern web apps

61 lines (60 loc) 2.03 kB
import { LocationStrategy } from './location_strategy'; import { PlatformLocation, UrlChangeListener } from './platform_location'; /** * `PathLocationStrategy` is a {@link LocationStrategy} used to configure the * {@link Location} service to represent its state in the * [path](https://en.wikipedia.org/wiki/Uniform_Resource_Locator#Syntax) of the * browser's URL. * * `PathLocationStrategy` is the default binding for {@link LocationStrategy} * provided in {@link ROUTER_PROVIDERS}. * * If you're using `PathLocationStrategy`, you must provide a provider for * {@link APP_BASE_HREF} to a string representing the URL prefix that should * be preserved when generating and recognizing URLs. * * For instance, if you provide an `APP_BASE_HREF` of `'/my/app'` and call * `location.go('/foo')`, the browser's URL will become * `example.com/my/app/foo`. * * ### Example * * ``` * import {Component, provide} from 'angular2/core'; * import { * APP_BASE_HREF * ROUTER_DIRECTIVES, * ROUTER_PROVIDERS, * RouteConfig, * Location * } from 'angular2/router'; * * @Component({directives: [ROUTER_DIRECTIVES]}) * @RouteConfig([ * {...}, * ]) * class AppCmp { * constructor(location: Location) { * location.go('/foo'); * } * } * * bootstrap(AppCmp, [ * ROUTER_PROVIDERS, // includes binding to PathLocationStrategy * provide(APP_BASE_HREF, {useValue: '/my/app'}) * ]); * ``` */ export declare class PathLocationStrategy extends LocationStrategy { private _platformLocation; private _baseHref; constructor(_platformLocation: PlatformLocation, href?: string); onPopState(fn: UrlChangeListener): void; getBaseHref(): string; prepareExternalUrl(internal: string): string; path(): string; pushState(state: any, title: string, url: string, queryParams: string): void; replaceState(state: any, title: string, url: string, queryParams: string): void; forward(): void; back(): void; }