63 lines
2.0 KiB
TypeScript
63 lines
2.0 KiB
TypeScript
import {CONST_EXPR} from 'angular2/src/facade/lang';
|
|
import {OpaqueToken} from 'angular2/core';
|
|
import {UrlChangeListener} from './platform_location';
|
|
|
|
/**
|
|
* `LocationStrategy` is responsible for representing and reading route state
|
|
* from the browser's URL. Angular provides two strategies:
|
|
* {@link HashLocationStrategy} and {@link PathLocationStrategy} (default).
|
|
*
|
|
* This is used under the hood of the {@link Location} service.
|
|
*
|
|
* Applications should use the {@link Router} or {@link Location} services to
|
|
* interact with application route state.
|
|
*
|
|
* For instance, {@link HashLocationStrategy} produces URLs like
|
|
* `http://example.com#/foo`, and {@link PathLocationStrategy} produces
|
|
* `http://example.com/foo` as an equivalent URL.
|
|
*
|
|
* See these two classes for more.
|
|
*/
|
|
export abstract class LocationStrategy {
|
|
abstract path(): string;
|
|
abstract prepareExternalUrl(internal: string): string;
|
|
abstract pushState(state: any, title: string, url: string, queryParams: string): void;
|
|
abstract replaceState(state: any, title: string, url: string, queryParams: string): void;
|
|
abstract forward(): void;
|
|
abstract back(): void;
|
|
abstract onPopState(fn: UrlChangeListener): void;
|
|
abstract getBaseHref(): string;
|
|
}
|
|
|
|
|
|
/**
|
|
* The `APP_BASE_HREF` token represents the base href to be used with the
|
|
* {@link PathLocationStrategy}.
|
|
*
|
|
* If you're using {@link PathLocationStrategy}, you must provide a provider to a string
|
|
* representing the URL prefix that should be preserved when generating and recognizing
|
|
* URLs.
|
|
*
|
|
* ### Example
|
|
*
|
|
* ```
|
|
* import {Component} from 'angular2/core';
|
|
* import {ROUTER_DIRECTIVES, ROUTER_PROVIDERS, RouteConfig} from 'angular2/router';
|
|
* import {APP_BASE_HREF} from 'angular2/platform/common';
|
|
*
|
|
* @Component({directives: [ROUTER_DIRECTIVES]})
|
|
* @RouteConfig([
|
|
* {...},
|
|
* ])
|
|
* class AppCmp {
|
|
* // ...
|
|
* }
|
|
*
|
|
* bootstrap(AppCmp, [
|
|
* ROUTER_PROVIDERS,
|
|
* provide(APP_BASE_HREF, {useValue: '/my/app'})
|
|
* ]);
|
|
* ```
|
|
*/
|
|
export const APP_BASE_HREF: OpaqueToken = CONST_EXPR(new OpaqueToken('appBaseHref'));
|