Spec-Zone.ru › Angular.js 1.6

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

  • $routeChangeError

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

    Тип:

    вещание

    Целевая область:

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

    Параметры

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

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

    current Route

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

    previous Route

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

    rejection Route

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

  • $routeUpdate

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

    Тип:

    вещание

    Целевая область:

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

    Параметры

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

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

    current Route

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

Свойства

  • current

    Object

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

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

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

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

  • routes

    Object

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

Пример

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

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

Spec-Zone.ru

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