Spec-Zone.ru › Angular.js 1.7

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

    Тип:

    вещание

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

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

    Параметры

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

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

    current Route

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

Свойства

  • текущий

    Object

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

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

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

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

  • маршруты

    Object

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

Пример

Этот пример демонстрирует, как изменение хэша URL приводит к тому, что $route сопоставляет маршрут с URL, и ngView подключает частичный шаблон.

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

Spec-Zone.ru

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