LocationServices | @uirouter/angularjs
Options
Menu

Interface LocationServices

Hierarchy

Implemented by

Index

Methods

Methods

  • dispose(router?: UIRouter): any

  • Instructs the Disposable to clean up any resources

  • hash(): string

  • Gets the hash part of the current url

  • Gets the hash part of the current url

    If the current URL is /some/path?query=value#anchor, this returns anchor

    Returns string

    :

    the hash (anchor) portion of the url

  • onChange(callback: Function): Function

  • Registers a url change handler

  • Registers a url change handler

    Example:

    let deregisterFn = locationServices.onChange((evt) => console.log("url change", evt));

    Parameters

    • callback Function
      :

      a function that will be called when the url is changing

    Returns Function

    :

    a function that de-registers the callback

  • path(): string

  • Gets the path part of the current url

  • Gets the path part of the current url

    If the current URL is /some/path?query=value#anchor, this returns /some/path

    Returns string

    :

    the path portion of the url

  • search(): object

  • Gets the search part of the current url as an object

  • Gets the search part of the current url as an object

    If the current URL is /some/path?query=value#anchor, this returns { query: 'value' }

    Returns object

    :

    the search (querystring) portion of the url, as an object

    • [key: string]: any
  • url(): string

  • Gets the current url string

  • url(newurl: string, replace?: boolean, state?: any): string

  • Updates the url, or gets the current url

  • Gets the current url string

    The URL is normalized using the internal path/search/hash values.

    For example, the URL may be stored in the hash ([[HashLocationServices]]) or have a base HREF prepended ([[PushStateLocationServices]]).

    The raw URL in the browser might be:

    http://mysite.com/somepath/index.html#/internal/path/123?param1=foo#anchor

    or

    http://mysite.com/basepath/internal/path/123?param1=foo#anchor

    then this method returns:

    /internal/path/123?param1=foo#anchor

    Example:

    locationServices.url(); // "/some/path?query=value#anchor"

    Returns string

    :

    the current value of the url, as a string.

  • Updates the url, or gets the current url

    Updates the url, changing it to the value in newurl

    Example:

    locationServices.url("/some/path?query=value#anchor", true);

              This url should reflect only the new internal <a href="common.locationservices.html#path">path</a>, <a href="common.locationservices.html#search">search</a>, and <a href="common.locationservices.html#hash">hash</a> values.
          It should not include the protocol, site, port, or base path of an absolute HREF.

    Parameters

    • newurl string
      :

      The new value for the URL.

    • replace: Optional  boolean
      :

      When true, replaces the current history entry (instead of appending it) with this new url

    • state: Optional  any
      :

      The history's state object, i.e., pushState (if the LocationServices implementation supports it)

    Returns string

    :

    the url (after potentially being processed)

Generated using TypeDoc