angular的uiRouter服务学习(3)
本篇接着上一篇 angular的uiRouter服务学习(2) 继续讲解uiRouter的用法
本篇主要讲解uiRouter的多个命名的视图
我们可以给ui-view元素添加ui-view的值来给它命名,这样,一个视图模板里就可以有多个ui-view标签.
比如下面这个应用,它需要动态的填充一个图表,图表里有一些表格数据,筛选项,等:
给视图命名,需要在状态里定义views属性. views的属性值为一个对象.
views属性会覆盖template属性:
如果给状态定义了views属性,那么状态的template,templateUrl,templateProvider将会被无视掉. 考虑这种场景: 一个父视图模板,里面需要包含多个不同的视图. 在这种情况下,可以定义一个抽象状态来充当父状态,然后在子状态里定义views属性.
栗子-name匹配:
views对象里的属性名应该和ui-view元素里面的值所对应,像下面这样:
html:
<div> <a href="report">查看视图</a> <div ui-view></div> <div ui-view="filters"></div> <div ui-view="tabledata"></div> <div ui-view="graph"></div> </div>
js:
var named = angular.module('namedView',['ui.router']); var report = { name:'report', url:'/report', views:{ 'filters':{ templateUrl:'report-filters.html', controller:function($scope){ $scope.title="我是filters的内容" } }, 'tabledata':{ templateUrl:'report-table.html', controller:function($scope){ $scope.title="我是table的内容" } }, 'graph':{ templateUrl:'report-graph.html', controller:function($scope){ $scope.title="我是graph的内容" } } } }; named.config(function($locationProvider,$stateProvider){ $locationProvider.html5Mode({enabled:true}).hashPrefix('!'); $stateProvider.state(report) });
report-filters.html,report-graph.html,report-table.html:
<h3>{{title}}</h3>
点击'查看视图'激活report状态:
可以看到,report状态被激活后,它有三个ui-view,不同的ui-view有不同的名字,然后通过定义状态的views属性来分别给三个ui-view定义templateUrl,controller.
视图名-相对名字和绝对名字:
views对象的视图名,有两种取法,一种是相对名字,一种是绝对名字.刚才我们看到的例子是绝对名字.如果是相对名字的话,要符合 viewname@statename 这种格式. 其中,viewname就是视图中ui-view属性值; statename是状态名. 连起来就是:在statename状态下,寻找ui-view属性值为对应viewname的元素.
还需要注意一点,viewname可以使用'-'分割的名字,但和指令不同,在js代码里不需要把'-'转换成驼峰命名的格式,而是保持'-'分割的名字就可以了.
比如上面的例子,我们可以把它写成相对名字:
views:{ 'filters@':{ ... } }, 'tabledata@':{ ... } }, 'graph@':{ ... } } }
这样,视图名就变成了相对名字,这里statename为空,表示根状态,也就是起始html页面.
相对名字可以做一些很强大的视图匹配.比如下面这样一个例子:
named-views.html:
<div> <a href="report">查看视图</a> <a href="report/detail">查看子视图</a> <div ui-view>没有ui-view值</div> <div ui-view="aaa">ui-view值为aaa</div> </div>
js:
var named = angular.module('namedView',['ui.router']); var report = { name:'report', url:'/report', templateUrl:'report.html' }; var detail = { name:'report.detail', url:'/detail', parent:'report', views:{ //绝对名字:在父状态的template(也就是report.html)里寻找对应名字为'aaa'的ui-view元素 'aaa':{ templateUrl:'aaa.html' },
//绝对名字:在父状态的template(也就是report.html)里寻找没有名字的ui-view元素 '':{ templateUrl:'report.detail.html' },
/*
'aaa@report':{ templateUrl:'aaa.html' }, '@report':{ templateUrl:'report.detail.html' },*/
//相对名字:在report.detail状态里寻找对应名字为'bbb'的ui-view元素 'bbb@report.detail':{ templateUrl:'bbb.html' }, //相对名字:在report.detail状态里寻找对应没有名字的ui-view元素 '@report.detail':{ templateUrl:'no-name.html' },
//相对名字:在report状态里寻找对应名字为'bbb'的ui-view元素 'bbb@report':{ templateUrl:'bbb2.html' }, //相对名字:在根状态(named-views.html)里寻找对应名字为'aaa'的ui-view元素 'aaa@':{ templateUrl:'aaa2.html' },
//相对名字:在根状态(named-views.html)里寻找没有名字的ui-view元素. //需要特别注意:这里等于是在子状态里定义了父状态的里ui-view,要这样写的话,最开始的两段绝对名字'aaa'和'',就必须改成下面注释的两段相对名字'aaa@report'和'bbb@report'. //否则会造成错误. /*
'@':{ templateUrl:'report.html' }*/ } }; named.config(function($locationProvider,$stateProvider){ $locationProvider.html5Mode({enabled:true}).hashPrefix('!'); $stateProvider.state(report).state(detail) });
report.html:
<h1>report.html:</h1> <div> <h2>ui-view值为空的内容:</h2> <div ui-view></div> </div> <div> <h2>ui-view值为'aaa'的内容:</h2> <div ui-view="aaa"></div> </div> <div> <h2>ui-view值为'bbb'的内容:</h2> <div ui-view="bbb"></div> </div>
report.detail.html:
<h3>report.detail.html:</h3> <div> <h4>ui-view值为空的内容:</h4> <div ui-view></div> </div> <div> <h4>ui-view值为'bbb'的内容:</h4> <div ui-view="bbb"></div> </div>
aaa.html:
<h3>aaa.html:</h3>
bbb.html:
<h5>bbb.html</h5>
aaa2.html:
<h1>aaa2.html:</h1>
bbb2.html:
<h3>bbb2.html</h3>
no-name.html:
<h5>no-name.html</h5>
点击'查看视图':
点击'查看子视图':
下面分析一下视图的加载:
1.当进入report状态时,会用report.html来填充named-views.html里面的ui-view元素. (ui-view="aaa")不会被填充
2.进入report状态的子状态:report.detail状态.
(1)'aaa': 绝对名字,在父状态的视图模板里寻找对应名字为'aaa'的ui-view元素. 然后使用'aaa.html'来填充它.
(2)'': 绝对名字,在父状态的视图模板里寻找没有名字的ui-view元素.然后使用'report.detail.html'来填充它.
(3)'aaa@report': 相对名字,在report状态里寻找对应名字为'aaa'的ui-view元素. 然后使用'aaa.html'来填充它.
(4)'@report': 相对名字,在report状态里寻找没有名字的ui-view元素.然后使用'report.detail.html'来填充它.
* 注意,(1)(2)和(3)(4),一个是绝对,一个是相对,但其实都是在report状态里寻找.它们两者的区别最后会说到.
(5)'bbb@report.detail': 相对名字,在report.detail状态里寻找对应名字为'bbb'的ui-view元素.然后使用'bbb.html'来填充它.
(6)'@report.detail': 相对名字,在report.detail状态里寻找没有名字的ui-view元素.然后使用no-name.html来填充它.
(7)'bbb@report': 相对名字,在report状态里寻找对应名字为'bbb'的ui-view元素,然后使用'bbb2.html'来填充它.
(8)'aaa@': 相对名字,@后面为空,就表示在根状态(也就是named-views.html)里寻找对应名字为aaa的ui-view元素,然后使用'aaa2.html'来填充它
(9)'@': 相对名字, 表示在根状态(也就是named-views.html)里寻找没有名字的ui-view元素,然后使用'report.html'来填充它.
(9)的填充方式,和1的填充,从视图匹配的角度来说,是完全一致的,都是在named-views.html里寻找没有名字的ui-view元素,然后用同一个模板来填充它.但是,从使用的角度来说,他们是不同的.
就拿这个栗子来说: 我这里是把'@'给注释掉了,因为一旦使用了'@',那么(1)(2)'aaa'和''这两个绝对名字,会找不到他们父状态的视图模板.因为他们父状态的视图模板是通过相对名字来定义的.这个时候,如果要用'@',就必须使用(3)(4)'aaa@report'和'@report'.
*总结来说,绝对名字和相对名字,在一个状态里最好不要混用.
完整代码:https://github.com/OOP-Code-Bunny/angular/tree/master/uiRouter
参考原文:https://github.com/angular-ui/ui-router/wiki/Multiple-Named-Views
