W3cubDocs

/Angular 12

HashLocationStrategy

class final

A LocationStrategy used to configure the Location service to represent its state in the hash fragment of the browser's URL.

See more...

class HashLocationStrategy extends LocationStrategy implements OnDestroy {
  override
  ngOnDestroy(): void
  onPopState(fn: LocationChangeListener): void
  getBaseHref(): string
  path(includeHash: boolean = false): string
  prepareExternalUrl(internal: string): string
  pushState(state: any, title: string, path: string, queryParams: string)
  replaceState(state: any, title: string, path: string, queryParams: string)
  forward(): void
  back(): void
  historyGo(relativePosition: number = 0): void

  // inherited from common/LocationStrategy
  abstract path(includeHash?: boolean): 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
  historyGo(relativePosition: number)?: void
  abstract onPopState(fn: LocationChangeListener): void
  abstract getBaseHref(): string
}

Description

For instance, if you call location.go('/foo'), the browser's URL will become example.com#/foo.

Further information is available in the Usage Notes...

Properties

Property Description
override

Methods

ngOnDestroy(): void

Parameters

There are no parameters.

Returns

void

onPopState(fn: LocationChangeListener): void

Parameters
fn LocationChangeListener
Returns

void

getBaseHref(): string

Parameters

There are no parameters.

Returns

string

path(includeHash: boolean = false): string

Parameters
includeHash boolean

Optional. Default is false.

Returns

string

prepareExternalUrl(internal: string): string

Parameters
internal string
Returns

string

pushState(state: any, title: string, path: string, queryParams: string)

Parameters
state any
title string
path string
queryParams string

replaceState(state: any, title: string, path: string, queryParams: string)

Parameters
state any
title string
path string
queryParams string

forward(): void

Parameters

There are no parameters.

Returns

void

back(): void

Parameters

There are no parameters.

Returns

void

historyGo(relativePosition: number = 0): void

Parameters
relativePosition number

Optional. Default is 0.

Returns

void

Usage notes

Example

import {HashLocationStrategy, Location, LocationStrategy} from '@angular/common';
import {Component} from '@angular/core';

@Component({
  selector: 'hash-location',
  providers: [Location, {provide: LocationStrategy, useClass: HashLocationStrategy}],
  template: `
    <h1>HashLocationStrategy</h1>
    Current URL is: <code>{{location.path()}}</code><br>
    Normalize: <code>/foo/bar/</code> is: <code>{{location.normalize('foo/bar')}}</code><br>
  `
})
export class HashLocationComponent {
  location: Location;
  constructor(location: Location) {
    this.location = location;
  }
}

© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v12.angular.io/api/common/HashLocationStrategy