UNPKG

@angular/common

Version:

Angular - commonly needed directives and services

42 lines (41 loc) 1.68 kB
import { LocationStrategy } from './location_strategy'; import { LocationChangeListener, PlatformLocation } from './platform_location'; /** * @whatItDoes Use URL for storing application location data. * @description * `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. * * If you're using `PathLocationStrategy`, you must provide a {@link APP_BASE_HREF} * or add a base element to the document. This URL prefix that will 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`. * * Similarly, if you add `<base href='/my/app'/>` to the document and call * `location.go('/foo')`, the browser's URL will become * `example.com/my/app/foo`. * * ### Example * * {@example common/location/ts/path_location_component.ts region='LocationComponent'} * * @stable */ export declare class PathLocationStrategy extends LocationStrategy { private _platformLocation; private _baseHref; constructor(_platformLocation: PlatformLocation, href?: string); onPopState(fn: LocationChangeListener): void; getBaseHref(): string; prepareExternalUrl(internal: string): string; path(includeHash?: boolean): 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; }