Spec-Zone.ru › Angular.js 1.4

Улучшить эту документацию Просмотреть исходный код $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 установлено в 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.4.14/docs/api/ngRoute/service/$route

Spec-Zone.ru

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