Spec-Zone.ru › Angular.js 1.3

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

  1. $routeProvider
  2. сервис в модуле ngRoute

$route используется для глубокой привязки URL-адресов к контроллерам и представлениям (HTML-фрагментам). Он отслеживает $location.url() и пытается сопоставить путь с существующим определением маршрута.

Требуется модуль ngRoute.

Вы можете определять маршруты через API $routeProvider.

Сервис $route обычно используется в сочетании с директивой ngView и сервисом $routeParams.

Зависимости

  • $location
  • $routeParams

Методы

  • reload();

    Принуждает сервис $route перезагрузить текущий маршрут, даже если $location не изменился.

    В результате ngView создаёт новую область видимости и повторно инициализирует контроллер.

  • updateParams(newParams);

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

    Параметры

    Параметр Тип Подробности
    newParams !Object<string, string>

    отображение имён параметров URL к значениям

События

  • $routeChangeStart

    Транслируется перед изменением маршрута. На этом этапе службы маршрутизации начинают разрешать все зависимости, необходимые для изменения маршрута. Обычно это включает получение шаблона представления, а также любых зависимостей, определённых в свойстве маршрута resolve . После разрешения всех зависимостей, транслируется $routeChangeSuccess.

    Изменение маршрута (и связанное с ним изменение $location ) можно предотвратить, вызвав метод preventDefault события. Подробнее об объекте события см. $rootScope.Scope.

    Тип:

    трансляция

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

    корневая область видимости

    Параметры

    Параметр Тип Подробности
    angularEvent Object

    Синтетический объект события.

    next Route

    Информация о будущем маршруте.

    current Route

    Информация о текущем маршруте.

  • $routeChangeSuccess

    Транслируется после успешного изменения маршрута. Зависимости resolve теперь доступны в свойстве current.locals.

    ngView прослушивает событие для инициализации контроллера и отображения представления.

    Тип:

    трансляция

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

    корневая область видимости

    Параметры

    Параметр Тип Подробности
    angularEvent Object

    Синтетический объект события.

    current Route

    Информация о текущем маршруте.

    previous RouteUndefined

    Информация о предыдущем маршруте, или undefined, если текущий — первый введённый маршрут.

  • $routeChangeError

    Транслируется, если любой из промисов resolve отклоняется.

    Тип:

    трансляция

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

    корневая область видимости

    Параметры

    Параметр Тип Подробности
    angularEvent Object

    Синтетический объект события

    current Route

    Информация о текущем маршруте.

    previous Route

    Информация о предыдущем маршруте.

    rejection Route

    Отклонение промиса. Обычно ошибка неисправного промиса.

  • $routeUpdate

    Свойство reloadOnSearch установлено в false, и мы повторно используем тот же экземпляр контроллера.

    Тип:

    трансляция

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

    корневая область видимости

    Параметры

    Параметр Тип Подробности
    angularEvent Object

    Синтетический объект события

    current Route

    Информация о текущем/предыдущем маршруте.

Свойства

  • current

    Object

    Ссылка на текущее определение маршрута. Определение маршрута содержит:

    • controller: Конструктор контроллера, как определено в определении маршрута.
    • locals: Карта локалей, которая используется сервисом $controller для создания контроллера. Карта locals содержит разрешённые значения карты resolve. Кроме того, карта locals также содержит:

      • $scope - текущая область видимости маршрута.
      • $template - текущий HTML-шаблон маршрута.
  • routes

    Object

    Объект со всеми объектами конфигурации маршрута в качестве своих свойств.

В этом примере показано, как изменение URL-хэша заставляет $route сопоставлять маршрут с URL-адресом, а ngView подключает фрагмент.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ngRoute/service/$route

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API