angular -- $route API翻译

$route

-$routeProvider服务

-依赖ngRoute模块

$route能够在路径发生改变的时候,渲染不同的视图,调用不同的控制器.它监测了$location.url(),然后根据路径来匹配相应的路由,路由的定义方法详见$routeProvider的API.

$route通常和$routeProvider服务和ngView指令一起使用

依赖:

$location
$routeParams

方法:

reload()

在路由没有改变的时候,再次加载当前路径的路由,重新渲染ng-view,实例化一个控制器

事件:

$routeChangeStart

在路由变化之前被触发,在这个时间点上,路由服务会resolve所有的路由变化所需要的依赖(详见$routeProvider),以及获取需要被渲染的视图模板,已经解析所有加载新路由所需要的依赖.当所有的依赖都被解析以后,$routeChangeSuccess事件就会被触发

类型: broadcast

目标元素: root scope(即在根作用域内绑定)

$routeChangeSuccess

在所有路由依赖被解析完成后触发,ng-view会根据指令实例化控制器,渲染视图

类型: broadcast

目标元素: root scope

$routeChangeError

当解析路由依赖时,promise对象没有正常解析,而是reject出错的时候被触发. (详见$q)

类型: broadcast

目标元素: root scope

$routeUpdate

reloadOnSearch属性设置为false,再次使用相同的控制器实例

这个属性在$route.current.$route对象里

类型: broadcast

目标元素: root scope

属性:

(以下这段不是翻译,胜似翻译)

$route对象共有三个属性:

1.current

current对象又有以下几个属性:

①$route:

$route对象包含controller属性: 当前视图的控制器

$route对象包含reloadOnSearch属性: 见上

$route对象包含resolve属性: 需要被解析的依赖(还没有解析)

$route对象包含templateUrl属性: 视图模板路径

②locals:

locals对象包含$scope属性: 当前作用域

locals对象包含$template属性: 视图模板的内容

locals对象还包含已经解析完的依赖(在这里就是recipe属性)

③params:

当前路径的参数对象

④pathParams:

也是当前路径的参数对象(区别不详)

2.reload方法

3.routes对象:

routes对象包含了当前单页应用的所有路由规则,每个路由规则所对应的视图模板,控制器,依赖,以及reloadOnSearch属性

这里是一个$route的demo,这个demo故意延迟路由的resolve的解析时间,

通过这个demo可以看到,分析下面这几项的变化情况:

$location.path():

路由一变化就随之变化,获取新的url

$route.current.templateUrl:

路由一变化就随之变化,获取新路由的模板url

$route.current.params:

路由一变化就随之变化,获取新路由的模板url的参数

$route.current.scope:

路由一变化,它会成为空,等到路由变化完成,再把新路由的作用域赋给它

$routeParam:

路由一变化,它不会变为空,会保持上一次路由变化,等到路由变化完成,再把新路由url参数赋给它

视图:

路由变化完成后进行渲染

demo地址:

https://github.com/OOP-Code-Bunny/angular/tree/master/%24route