Spec-Zone.ru › Angular.js 1.5

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

    Тип:

    broadcast

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

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

    Параметры

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

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

    next Route

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

    current Route

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

  • $routeChangeSuccess

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

    ngView прослушивает директиву для создания экземпляра контроллера и рендеринга представления.

    Тип:

    broadcast

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

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

    Параметры

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

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

    current Route

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

    previous RouteUndefined

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

  • $routeChangeError

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

    Тип:

    broadcast

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

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

    Параметры

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

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

    current Route

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

    previous Route

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

    rejection Route

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

  • $routeUpdate

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

    Тип:

    broadcast

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

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

    Параметры

    Параметр Тип Подробности
    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–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.5.11/docs/api/ngRoute/service/$route

Spec-Zone.ru

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