©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
AngularJS: API: ngRoute/provider/$routeProvider
$routeProvider
- - $route
- - provider in module ngRoute
Used for configuring routes.
示例
参见 $route for an example of configuring and using ngRoute.
依赖
Requires the ngRoute module to be installed.
用法
$routeProvider();
方法
-
when(path, route);Adds a new route definition to the
$routeservice.参数
参数 类型 详述 path string Route path (matched against
$location.path). If$location.pathcontains redundant trailing slash or is missing one, the route will still match and the$location.pathwill be updated to add or drop the trailing slash to exactly match the route definition.-
pathcan contain named groups starting with a colon:例如:名称. All characters up to the next slash are matched and stored in$routeParamsunder the given名称when the route matches. -
pathcan contain named groups starting with a colon and ending with a star:例如:名称*. All characters are eagerly stored in$routeParamsunder the given名称when the route matches. -
pathcan contain optional named groups with a question mark:例如:名称?.例如，routes like
/color/:color/largecode/:largecode*\/editwill match/color/brown/largecode/code/with/slashes/editand extract: -
color: brown -
largecode: code/with/slashes.
route Object Mapping information to be assigned to
$route.currenton route match.Object properties:
-
controller–{(string|Function()=}– Controller fn that should be associated with newly created scope or the name of a registered controller if passed as a string. -
controllerAs–{string=}– A controller alias name. If present the controller will be published to scope under thecontrollerAsname. -
template–{string=|Function()=}– html template as a string or a function that returns an html template as a string which should be used by ngView or ngInclude directives. This property takes precedence overtemplateUrl.If
templateis a function, it will be called with the following parameters:-
{Array.<Object>}- route parameters extracted from the current$location.path()by applying the current route
-
-
templateUrl–{string=|Function()=}– path or function that returns a path to an html template that should be used by ngView.If
templateUrlis a function, it will be called with the following parameters:-
{Array.<Object>}- route parameters extracted from the current$location.path()by applying the current route
-
-
resolve-{Object.<string, Function>=}- An optional map of dependencies which should be injected into the controller. If any of these dependencies are promises, the router will wait for them all to be resolved or one to be rejected before the controller is instantiated. If all the promises are resolved successfully, the values of the resolved promises are injected and $routeChangeSuccess event is fired. If any of the promises are rejected the $routeChangeError event is fired. The map object is:-
key–{string}: a name of a dependency to be injected into the controller. -
factory-{string|Function}: Ifstringthen it is an alias for a service. Otherwise if function, then it is injected and the return value is treated as the dependency. If the result is a promise, it is resolved before its value is injected into the controller. Be aware thatngRoute.$routeParamswill still refer to the previous route within these resolve functions. Use$route.current.paramsto access the new route parameters, instead.
-
-
redirectTo– {(string|function())=} – value to update $location path with and trigger route redirection.If
redirectTois a function, it will be called with the following parameters:-
{Object.<string>}- route parameters extracted from the current$location.path()by applying the current route templateUrl. -
{string}- current$location.path() -
{Object}- current$location.search()
The custom
redirectTofunction is expected to return a string which will be used to update$location.path()and$location.search(). -
-
[reloadOnSearch=true]- {boolean=} - reload route when only$location.search()or$location.hash()changes.If the option is set to
falseand url in the browser changes, then$routeUpdateevent is broadcasted on the root scope. -
[caseInsensitiveMatch=false]- {boolean=} - match routes without being case sensitiveIf the option is set to
true, then the particular route can be matched without being case sensitive
返回值
Object self
-
-
otherwise(params);Sets route definition that will be used on route change when no other route definition is matched.
参数
参数 类型 详述 params Object Mapping information to be assigned to
$route.current.返回值
Object self