目錄 搜尋
AngularJS API Reference auto auto/service auto/service/$injector auto/service/$provide ng ng/directive ng/directive/a ng/directive/form ng/directive/input ng/directive/input[checkbox] ng/directive/input[date] ng/directive/input[dateTimeLocal] ng/directive/input[email] ng/directive/input[month] ng/directive/input[number] ng/directive/input[radio] ng/directive/input[text] ng/directive/input[time] ng/directive/input[url] ng/directive/input[week] ng/directive/ngApp ng/directive/ngBind ng/directive/ngBindHtml ng/directive/ngBindTemplate ng/directive/ngBlur ng/directive/ngChange ng/directive/ngChecked ng/directive/ngClass ng/directive/ngClassEven ng/directive/ngClassOdd ng/directive/ngClick ng/directive/ngCloak ng/directive/ngController ng/directive/ngCopy ng/directive/ngCsp ng/directive/ngCut ng/directive/ngDblclick ng/directive/ngDisabled ng/directive/ngFocus ng/directive/ngForm ng/directive/ngHide ng/directive/ngHref ng/directive/ngIf ng/directive/ngInclude ng/directive/ngInit ng/directive/ngKeydown ng/directive/ngKeypress ng/directive/ngKeyup ng/directive/ngList ng/directive/ngModel ng/directive/ngModelOptions ng/directive/ngMousedown ng/directive/ngMouseenter ng/directive/ngMouseleave ng/directive/ngMousemove ng/directive/ngMouseover ng/directive/ngMouseup ng/directive/ngNonBindable ng/directive/ngOpen ng/directive/ngPaste ng/directive/ngPluralize ng/directive/ngReadonly ng/directive/ngRepeat ng/directive/ngSelected ng/directive/ngShow ng/directive/ngSrc ng/directive/ngSrcset ng/directive/ngStyle ng/directive/ngSubmit ng/directive/ngSwitch ng/directive/ngTransclude ng/directive/ngValue ng/directive/script ng/directive/select ng/directive/textarea ng/filter ng/filter/currency ng/filter/date ng/filter/filter ng/filter/json ng/filter/limitTo ng/filter/lowercase ng/filter/number ng/filter/orderBy ng/filter/uppercase ng/function ng/function/angular.bind ng/function/angular.bootstrap ng/function/angular.copy ng/function/angular.element ng/function/angular.equals ng/function/angular.extend ng/function/angular.forEach ng/function/angular.fromJson ng/function/angular.identity ng/function/angular.injector ng/function/angular.isArray ng/function/angular.isDate ng/function/angular.isDefined ng/function/angular.isElement ng/function/angular.isFunction ng/function/angular.isNumber ng/function/angular.isObject ng/function/angular.isString ng/function/angular.isUndefined ng/function/angular.lowercase ng/function/angular.module ng/function/angular.noop ng/function/angular.toJson ng/function/angular.uppercase ng/object ng/object/angular.version ng/provider ng/provider/$animateProvider ng/provider/$compileProvider ng/provider/$controllerProvider ng/provider/$filterProvider ng/provider/$httpProvider ng/provider/$interpolateProvider ng/provider/$locationProvider ng/provider/$logProvider ng/provider/$parseProvider ng/provider/$rootScopeProvider ng/provider/$sceDelegateProvider ng/provider/$sceProvider ng/service ng/service/$anchorScroll ng/service/$animate ng/service/$cacheFactory ng/service/$compile ng/service/$controller ng/service/$document ng/service/$exceptionHandler ng/service/$filter ng/service/$http ng/service/$httpBackend ng/service/$interpolate ng/service/$interval ng/service/$locale ng/service/$location ng/service/$log ng/service/$parse ng/service/$q ng/service/$rootElement ng/service/$rootScope ng/service/$sce ng/service/$sceDelegate ng/service/$templateCache ng/service/$timeout ng/service/$window ng/type ng/type/$cacheFactory.Cache ng/type/$compile.directive.Attributes ng/type/$rootScope.Scope ng/type/angular.Module ng/type/form.FormController ng/type/ngModel.NgModelController ngAnimate ngAnimate/provider ngAnimate/provider/$animateProvider ngAnimate/service ngAnimate/service/$animate ngCookies ngCookies/service ngCookies/service/$cookies ngCookies/service/$cookieStore ngMessages ngMessages/directive ngMessages/directive/ngMessage ngMessages/directive/ngMessages ngMock ngMock/function ngMock/function/angular.mock.dump ngMock/function/angular.mock.inject ngMock/function/angular.mock.module ngMock/object ngMock/object/angular.mock ngMock/provider ngMock/provider/$exceptionHandlerProvider ngMock/service ngMock/service/$exceptionHandler ngMock/service/$httpBackend ngMock/service/$interval ngMock/service/$log ngMock/service/$timeout ngMock/type ngMock/type/angular.mock.TzDate ngMockE2E ngMockE2E/service ngMockE2E/service/$httpBackend ngResource ngResource/service ngResource/service/$resource ngRoute ngRoute/directive ngRoute/directive/ngView ngRoute/provider ngRoute/provider/$routeProvider ngRoute/service ngRoute/service/$route ngRoute/service/$routeParams ngSanitize ngSanitize/filter ngSanitize/filter/linky ngSanitize/service ngSanitize/service/$sanitize ngTouch ngTouch/directive ngTouch/directive/ngClick ngTouch/directive/ngSwipeLeft ngTouch/directive/ngSwipeRight ngTouch/service ngTouch/service/$swipe
文字

AngularJS: API: ng/service/$location


$location

  1. - $locationProvider
  2. - service in module ng

The $location service parses the URL in the browser address bar (based on the window.location) and makes the URL available to your application. Changes to the URL in the address bar are reflected into $location service and changes to $location are reflected into the browser address bar.

The $location service:

  • Exposes the current URL in the browser address bar, so you can
    • Watch and observe the URL.
    • Change the URL.
  • Synchronizes the URL with the browser when the user
    • Changes the address bar.
    • Clicks the back or forward button (or clicks a History link).
    • Clicks on a link.
  • Represents the URL object as a set of methods (protocol, host, port, path, search, hash).

For more information see Developer Guide: Using $location

依赖

  • $rootElement

方法

  • absUrl();

    This method is getter only.

    Return full url representation with all segments encoded according to rules specified in RFC 3986.

    返回值

    string

    full url

  • url([url], [replace]);

    This method is getter / setter.

    Return url (如: /path?a=b#hash) when called without any parameter.

    Change path, search and hash, when called with parameter and return $location.

    参数

    参数 类型 详述
    url
    (可选)
    string

    New url without base prefix (如: /path?a=b#hash)

    replace
    (可选)
    string

    The path that will be changed

    返回值

    string

    url

  • protocol();

    This method is getter only.

    Return protocol of current url.

    返回值

    string

    protocol of current url

  • host();

    This method is getter only.

    Return host of current url.

    返回值

    string

    host of current url.

  • port();

    This method is getter only.

    Return port of current url.

    返回值

    Number

    port

  • path([path]);

    This method is getter / setter.

    Return path of current url when called without any parameter.

    Change path when called with parameter and return $location.

    注意: Path should always begin with forward slash (/), this method will add the forward slash if it is missing.

    参数

    参数 类型 详述
    path
    (可选)
    string

    New path

    返回值

    string

    path

  • search(search, [paramValue]);

    This method is getter / setter.

    Return search part (as object) of current url when called without any parameter.

    Change search part when called with parameter and return $location.

    // given url http://example.com/#/some/path?foo=bar&baz=xoxo
    var searchObject = $location.search();
    // => {foo: 'bar', baz: 'xoxo'}
    
    
    // set foo to 'yipee'
    $location.search('foo', 'yipee');
    // => $location

    参数

    参数 类型 详述
    search stringObject.<string>Object.<Array.<string>>

    New search params - string or hash object.

    When called with a single argument the method acts as a setter, setting the search component of $location to the specified value.

    If the argument is a hash object containing an array of values, these values will be encoded as duplicate search parameters in the url.

    paramValue
    (可选)
    stringArray.<string>boolean

    If search is a string, then paramValue will override only a single search property.

    If paramValue is an array, it will override the property of the search component of $location specified via the first argument.

    If paramValue is null, the property specified via the first argument will be deleted.

    If paramValue is true, the property specified via the first argument will be added with no value nor trailing equal sign.

    返回值

    Object

    If called with no arguments returns the parsed search object. If called with one or more arguments returns $location object itself.

  • hash([hash]);

    This method is getter / setter.

    Return hash fragment when called without any parameter.

    Change hash fragment when called with parameter and return $location.

    参数

    参数 类型 详述
    hash
    (可选)
    string

    New hash fragment

    返回值

    string

    hash

  • replace();

    If called, all changes to $location during current $digest will be replacing current history record, instead of adding new one.

事件

  • $locationChangeStart

    Broadcasted before a URL will change. This change can be prevented by calling preventDefault method of the event. See $rootScope.Scope for more details about event object. Upon successful change $locationChangeSuccess is fired.

    类型:

    broadcast

    目标:

    root scope
  • $locationChangeSuccess

    Broadcasted after a URL was changed.

    类型:

    broadcast

    目标:

    root scope

上一篇: 下一篇: