Spec-Zone.ru › Angular.js 1.8

Улучшить эту документацию Просмотреть исходный код $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

    Транслируется, если функция перенаправления завершается неудачей или любые перенаправления или разрешающие промисы отклоняются.

    Тип:

    трансляция

    Цель:

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

    Параметры

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

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

    current Route

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

    previous Route

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

    rejection Route

    Выброшенная ошибка или причина отклонения промиса. Обычно причина отклонения - это ошибка, которая привела к отклонению промиса.

  • $routeUpdate

    Транслируется, если используется тот же экземпляр маршрута (включая шаблон, экземпляр контроллера, разрешенные зависимости и т. д.). Это может произойти, если либо reloadOnSearch или reloadOnUrl было установлено в false.

    Тип:

    трансляция

    Цель:

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

    Параметры

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

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

    current Route

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

Свойства

  • current

    Object

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

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

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

      locals будет назначен свойству $resolve области видимости маршрута. Имя свойства можно переопределить, используя resolveAs в определении маршрута. Подробнее см. $routeProvider.

  • routes

    Object

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

Пример

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

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

Spec-Zone.ru

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