Улучшить эту документацию Просмотреть исходный код $route
- $routeProvider
- сервис в модуле ngRoute
$route используется для глубокой привязки URL к контроллерам и представлениям (HTML-фрагментам). Он отслеживает $location.url() и пытается сопоставить путь с существующим определением маршрута.
Требуется модуль ngRoute.
Вы можете определить маршруты через API $routeProvider.
Сервис $route обычно используется совместно с директивой ngView и сервисом $routeParams.
Зависимости
Методы
-
reload();
-
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