6f4ee6101c
This lets us skip src/facade/exception* when compiling modules other than core. It prevents having many conflicting declarations
94 lines
3.1 KiB
TypeScript
94 lines
3.1 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {BaseException, Inject, Injectable, Optional} from '@angular/core';
|
|
|
|
import {isBlank} from '../facade/lang';
|
|
|
|
import {Location} from './location';
|
|
import {APP_BASE_HREF, 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 {@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`.
|
|
*
|
|
* @stable
|
|
*/
|
|
@Injectable()
|
|
export class PathLocationStrategy extends LocationStrategy {
|
|
private _baseHref: string;
|
|
|
|
constructor(
|
|
private _platformLocation: PlatformLocation,
|
|
@Optional() @Inject(APP_BASE_HREF) href?: string) {
|
|
super();
|
|
|
|
if (isBlank(href)) {
|
|
href = this._platformLocation.getBaseHrefFromDOM();
|
|
}
|
|
|
|
if (isBlank(href)) {
|
|
throw new BaseException(
|
|
`No base href set. Please provide a value for the APP_BASE_HREF token or add a base element to the document.`);
|
|
}
|
|
|
|
this._baseHref = href;
|
|
}
|
|
|
|
onPopState(fn: UrlChangeListener): void {
|
|
this._platformLocation.onPopState(fn);
|
|
this._platformLocation.onHashChange(fn);
|
|
}
|
|
|
|
getBaseHref(): string { return this._baseHref; }
|
|
|
|
prepareExternalUrl(internal: string): string {
|
|
return Location.joinWithSlash(this._baseHref, internal);
|
|
}
|
|
|
|
path(includeHash: boolean = false): string {
|
|
const pathname = this._platformLocation.pathname +
|
|
Location.normalizeQueryParams(this._platformLocation.search);
|
|
const hash = this._platformLocation.hash;
|
|
return hash && includeHash ? `${pathname}${hash}` : pathname;
|
|
}
|
|
|
|
pushState(state: any, title: string, url: string, queryParams: string) {
|
|
var externalUrl = this.prepareExternalUrl(url + Location.normalizeQueryParams(queryParams));
|
|
this._platformLocation.pushState(state, title, externalUrl);
|
|
}
|
|
|
|
replaceState(state: any, title: string, url: string, queryParams: string) {
|
|
var externalUrl = this.prepareExternalUrl(url + Location.normalizeQueryParams(queryParams));
|
|
this._platformLocation.replaceState(state, title, externalUrl);
|
|
}
|
|
|
|
forward(): void { this._platformLocation.forward(); }
|
|
|
|
back(): void { this._platformLocation.back(); }
|
|
}
|