ui-router 的工作原理非常类似于 Angular 的路由控制器,但它只关注状态。
- 在应用程序的整个用户界面和导航中,一个状态对应于一个页面位置
- 通过定义controller、template和view等属性,来定义指定位置的用户界面和界面行为
- 通过嵌套的方式来解决页面中的一些重复出现的部位
最简单的形式
模板可以通过下面这种最简单的方式来指定
模板将被插入哪里?
状态被激活时,它的模板会自动插入到父状态对应的模板中包含ui-view属性的元素内部。如果是顶层的状态,那么它的父模板就是index.html。
激活状态
有三种方法来激活状态:
Templates 模板
可以通过下面几种方法来配置一个状态的模板。 方法一:配置template属性,指定一段 HTML 字符串,这人是设置模板的最简单的方式。
方法二:配置templateUrl属性,来加载指定位置的模板,这是设置模板的常用方法。
templateUrl 的值也可以是一个函数返回的url,函数带一个预设参数stateParams。
方法三:通过 templateProvider 函数返回模板的 HTML。
如果想在状态被激活前,让
Controllers 控制器
可以为模板指定一个控制器(controller)。警告:控制器不会被实例化如果模板没有定义。 设置控制器:
{{title}}
',controller: function($scope){ $scope.title = ' '; } })如果在模块中已经定义了一个控制器,只需要指定控制器的名称即可:
使用 controllerAs语法:
对于更高级的需要,可以使用controllerProvider来动态返回一个控制器函数或字符串:
控制器可以使用 $scope.on()
方法来监听事件状态转换。 控制器可以根据需要实例化,当相应的 scope 被创建时。例如,当用户点击一个 url 手动导航一个状态时,$stateProvider 将加载对应的模板到视图中,并且将控制器和模板的 scope 绑定在一起。
解决器 Resolver
可以使用 resolver 为控制器提供可选的依赖注入项。 resolver 配置项是一个由key/value构成的对象。
key – {string}
:注入控制器的依赖项名称。
factory – {string|function}
:
1、string:一个服务的别名
2、function:函数的返回值将作为依赖注入项,如果函数是一个耗时的操作,那么控制器必须等待该函数执行完成(be resolved)才会被实例化。
例子
在 controller 实例化之前,resolve 中的每一个对象都必须 be resolved,请注意每个 resolved object 是怎样作为参数注入到控制器中的。
<span class="hljs-comment">// Example using function with simple return value.
<span class="hljs-comment">// Since it's not a promise,it resolves immediately.
simpleObj: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(){
<span class="hljs-keyword">return {value: <span class="hljs-string">'simple!'};
},<span class="hljs-comment">// Example using function with returned promise.
<span class="hljs-comment">// 这是一种典型使用方式
<span class="hljs-comment">// 请给函数注入任何想要的服务依赖,例如 $http
promiSEObj: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(<span class="hljs-variable">$http){
<span class="hljs-comment">// $http returns a promise for the url data
<span class="hljs-keyword">return <span class="hljs-variable">$http({method: <span class="hljs-string">'GET',url: <span class="hljs-string">'/someUrl'});
},<span class="hljs-comment">// Another promise example.
<span class="hljs-comment">// 如果想对返回结果进行处理, 可以使用 .then 方法
<span class="hljs-comment">// 这是另一种典型使用方式
promiSEObj2: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(<span class="hljs-variable">$http){
<span class="hljs-keyword">return <span class="hljs-variable">$http({method: <span class="hljs-string">'GET',url: <span class="hljs-string">'/someUrl'})
.then (<span class="hljs-function"><span class="hljs-keyword">function <span class="hljs-params">(data) {
<span class="hljs-keyword">return doSomeStuffFirst(data);
});
},<span class="hljs-comment">// 使用服务名的例子,这将在模块中查找名称为 'translations' 的服务,并返回该服务
<span class="hljs-comment">// Note: The service could return a promise and
<span class="hljs-comment">// it would work just like the example above
translations: <span class="hljs-string">"translations",<span class="hljs-comment">// 将服务模块作为解决函数的依赖项,通过参数传入
<span class="hljs-comment">// 提示:依赖项 $stateParams 代表 url 中的参数
translations2: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(translations,<span class="hljs-variable">$stateParams){
<span class="hljs-comment">// Assume that getLang is a service method
<span class="hljs-comment">// that uses $http to fetch some translations.
<span class="hljs-comment">// Also assume our url was "/:lang/home".
translations.getLang(<span class="hljs-variable">$stateParams.lang);
},<span class="hljs-comment">// Example showing returning of custom made promise
greeting: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(<span class="hljs-variable">$q,<span class="hljs-variable">$timeout){
<span class="hljs-keyword">var deferred = <span class="hljs-variable">$q.defer();
<span class="hljs-variable">$timeout(<span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">() {
deferred.resolve(<span class="hljs-string">'Hello!');
},<span class="hljs-number">1000);
<span class="hljs-keyword">return deferred.promise;
}
},<span class="hljs-comment">// 控制器将等待上面的解决项都被解决后才被实例化
controller: <span class="hljs-function"><span class="hljs-keyword">function<span class="hljs-params">(<span class="hljs-variable">$scope,simpleObj,promiSEObj,promiSEObj2,translations,translations2,greeting){
<span class="hljs-variable">$scope.simple = simpleObj.value;
<span class="hljs-comment">// 这里可以放心使用 promiSEObj 中的对象
<span class="hljs-variable">$scope.items = promiSEObj.items;
<span class="hljs-variable">$scope.items = promiSEObj2.items;
<span class="hljs-variable">$scope.title = translations.getLang(<span class="hljs-string">"english").title;
<span class="hljs-variable">$scope.title = translations2.title;
<span class="hljs-variable">$scope.greeting = greeting;
}
})
为 $state 对象提供自定义数据
可以给 $state 对象提供自定义数据(建议使用data属性,以免冲突)
可以通过下面的方式来访问上面定义的数据:
onEnter 和 onExit 回调函数
onEnter和onExit回调函数是可选配置项,分别称为当一个状态变得活跃的和不活跃的时候触发。回调函数也可以访问所有解决依赖项。
State Change Events 状态改变事件
所有这些事件都是在$rootScope作用域触发
$stateChangeStart – 当模板开始解析之前触发
注意:使用event.preventDefault()
可以阻止模板解析的发生
$stateNotFound – v0.3.0 – 在 transition 时通过状态名查找状态,当状态无法找到时发生。该事件在 scope 链上广播,只允许一次处理错误的机会。unfoundState将作为参数传入事件监听函数,下面例子中可以看到unfoundState的三个属性。使用 event.preventDefault()
来阻止模板解析.
$stateChangeSuccess – 当模板解析完成后触发
$stateChangeError – 当模板解析过程中发生错误时触发
View Load Events 视图加载事件
$viewContentLoading – 当视图开始加载,DOM渲染完成之前触发,该事件将在$scope链上广播此事件。
$viewContentLoaded – 当视图加载完成,DOM渲染完成之后触发,视图所在的$scope发出该事件。