Улучшить документацию Просмотреть исходный код $location

Зависимости

• $rootElement

Методы

• absUrl();

  Этот метод является только для получения.

  Возвращает полное представление URL со всеми сегментами, закодированными в соответствии с правилами, указанными в RFC 3986.

  Возвращает

  string

  полный URL

• url([url]);

  Этот метод является для получения/установки.

  Возвращает URL (например, /path?a=b#hash) при вызове без параметров.

  Изменяет путь, поиск и хэш при вызове с параметром и возвращает $location.

  Параметры

  Параметр	Тип	Подробности
  url (необязательно)	string	Новый URL без префикса базы (например, /path?a=b#hash)

  Возвращает

  string

  URL

• protocol();

  Этот метод является только для получения.

  Возвращает протокол текущего URL.

  Возвращает

  string

  протокол текущего URL

• host();

  Этот метод является только для получения.

  Возвращает хост текущего URL.

  Возвращает

  string

  хост текущего URL.

• port();

  Этот метод является только для получения.

  Возвращает порт текущего URL.

  Возвращает

  Number

  порт

• path([path]);

  Этот метод является для получения/установки.

  Возвращает путь текущего URL при вызове без параметров.

  Изменяет путь при вызове с параметром и возвращает $location.

  Примечание: Путь всегда должен начинаться с прямой косой черты (/), этот метод добавит прямую косую черту, если она отсутствует.

  Параметры

  Параметр	Тип	Подробности
  path (необязательно)	stringnumber	Новый путь

  Возвращает

  string

  путь

• search(search, [paramValue]);

  Этот метод является для получения/установки.

  Возвращает часть поиска (как объект) текущего URL при вызове без параметров.

  Изменяет часть поиска при вызове с параметром и возвращает $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>>	Новые параметры поиска - строка или объект хэш. Когда вызывается с одним аргументом, метод действует как установщик, устанавливая компонент search объекта $location в указанное значение. Если аргумент является объектом хэш, содержащим массив значений, эти значения будут закодированы как дублируемые параметры поиска в URL.
  paramValue (необязательно)	stringNumberArray.<string>boolean	Если search является строкой или числом, то paramValue переопределит только одно свойство поиска. Если paramValue является массивом, он переопределит свойство компонента search объекта $location, указанного через первый аргумент. Если paramValue является null, свойство, указанное через первый аргумент, будет удалено. Если paramValue является true, свойство, указанное через первый аргумент, будет добавлено без значения и конечного знака равенства.

  Возвращает

  Object

  Если вызывается без аргументов, возвращает обработанный объект search. Если вызывается с одним или несколькими аргументами, возвращает сам объект $location.

• hash([hash]);

  Этот метод является для получения/установки.

  Возвращает фрагмент хэша при вызове без параметров.

  Изменяет фрагмент хэша при вызове с параметром и возвращает $location.

  Параметры

  Параметр	Тип	Подробности
  hash (необязательно)	stringnumber	Новый фрагмент хэша

  Возвращает

  string

  хэш

• replace();

  При вызове все изменения в $location в течение текущего $digest будут заменять текущую запись истории, вместо добавления новой.

События

• $locationChangeStart

  Выдается перед изменением URL. Это изменение можно предотвратить, вызвав метод preventDefault события. См. $rootScope.Scope для получения дополнительной информации об объекте события. После успешного изменения запускается $locationChangeSuccess.

  Тип:

  вещание

  Целевой объект:

  глобальный объект

• $locationChangeSuccess

  Выдается после изменения URL.

  Тип:

  вещание

  Целевой объект:

  глобальный объект