$route
service in module ngRoute
Description
$route
is used for deep-linking URLs to controllers and views (HTML partials). It watches $location.url()
and tries to map the path to an existing route definition.
Requires the ngRoute
module to be installed.
You can define routes through $routeProvider's API.
The $route
service is typically used in conjunction with the ngView
directive and the $routeParams
service.
Dependencies
$location
$routeParams
Methods
Causes $route
service to reload the current route even if $location
hasn't changed.
As a result of that, ngView creates new scope, reinstantiates the controller.
Properties
Reference to the current route definition. The route definition contains:
controller
: The controller constructor as define in route definition.locals
: A map of locals which is used by$controller
service for controller instantiation. Thelocals
contain the resolved values of theresolve
map. Additionally thelocals
also contain:$scope
- The current route scope.$template
- The current route template HTML.
Array of all configured routes.
Events
Broadcasted if any of the resolve promises are rejected.
Type:
broadcast
Target:
root scope
Parameters
ParamTypeDetailsangularEventObject
Synthetic event object
currentRoute
Current route information.
previousRoute
Previous route information.
rejectionRoute
Rejection of the promise. Usually the error of the failed promise.
Broadcasted before a route change. At this point the route services starts resolving all of the dependencies needed for the route change to occurs. Typically this involves fetching the view template as well as any dependencies defined in resolve
route property. Once all of the dependencies are resolved $routeChangeSuccess
is fired.
Type:
broadcast
Target:
root scope
Parameters
ParamTypeDetailsangularEventObject
Synthetic event object.
nextRoute
Future route information.
currentRoute
Current route information.
Broadcasted after a route dependencies are resolved. ngView listens for the directive to instantiate the controller and render the view.
Type:
broadcast
Target:
root scope
Parameters
ParamTypeDetailsangularEventObject
Synthetic event object.
currentRoute
Current route information.
Previous route information, or undefined if current is first route entered.
The reloadOnSearch
property has been set to false, and we are reusing the same instance of the Controller.
Type:
broadcast
Target:
root scope
Example
This example shows how changing the URL hash causes the $route
to match a route against the URL, and the ngView
pulls in the partial.
Note that this example is using inlined templates
to get it working on jsfiddle as well.