HanderBar

对于java开发,涉及到页面展示时,比较主流的有两种解决方案:

1. struts2+vo+el表达式。

这种方式,重点不在于struts2,而是vo和el表达式,其基本思想是:根据页面需要的信息,构造出一个实体,这个实体中包含了界面需要的所有属性,通常这个实体是由N个表中的字段构成的,俗称vo。由于vo的属性可以是String、List、Map等等等,又可以vo套vo,因此这种方式非常灵活,也非常好用。

在后台对vo进行赋值,通过struts2封装到request中,然后在界面用el表达式,通常是${}、forEach标签什么的,即可构造出界面。

但这种方式小菜却不是很看好。因为这种利用标签控制html,依然是把表现和控制混杂在一起,html里边混杂了大量el控制标签,很不美观。

当然,小菜不可能因为这么简单的理由拒绝这种方式,读者仔细思考可以发现,利用el表达式生成html代码,这是一个在服务器端执行的动作,在服务器端解析完成之后,才发送到客户端浏览器上,这样做会占用大量服务器资源,而且速度缓慢。

示例代码:

 1 <c:forEach var=‘bm‘ items="${contractAuditVo.borrowerModels}">
 2   <table>
 3     <tbody>
 4       <tr>
 5         <td>借款人编号:</td>
 6         <td>
 7           <p>
 8             ${bm.borrowerId }
 9           </p>
10         </td>
11       </tr>
12       <tr>
13         <td>客户编号:</td>
14         <td>
15           <p>
16             ${bm.customerId }
17           </p>
18         </td>
19       </tr>
20       <tr>
21         <td>曾用名:</td>
22         <td>
23           <p>
24             ${bm.usedName }
25           </p>
26         </td>
27       </tr>
28     </tbody>
29   </table>
30 </c:forEach>

         2. Json+ajax+拼html

这种方法一般是基于ajax请求,要求服务器端返回一个json类型的json字符串,这个json串中包含了界面所需的所有信息,界面拿到json串后,构造出html,完成界面展示。

小菜推荐这种方法,通过这种方式编写的页面,反应速度非常快,用户体验非常好。

因为服务器端只需要提供一个json串,由客户端完成解析,因此服务器承受的压力很小,目前的电脑配置都较高,客户端的浏览器解析js脚本很快,因此页面体验效果好。

解析的过程大致是通过Jquery的each方法,进行遍历。

但是小菜利用这种方式时,犯了一个致命的错误,小菜是通过原始的拼接html的方式,页面中写了大量html+=”<div>”;,这种写法使页面变得非常凌乱,几乎不可以维护。

示例代码:

 1 var contractTextHtml="";
 2 $.each(jsonObject.cl,function(i,n){
 3
 4   contractTextHtml="";
 5
 6   //插入合同文本数据
 7   contractTextHtml+="<div title=‘出借人信息---"+hiddenNull(n.cm.lenderName)+"‘ style=‘overflow:auto;padding:5px;‘>";
 8   contractTextHtml+="<table class=‘ui-table ui-table-noborder‘>";
 9   contractTextHtml+="<tbody>";
10   contractTextHtml+="<tr><td>合同编号:</td><td><p>"+hiddenNull(n.cm.contractId)+"</p></td></tr>";
11   contractTextHtml+="<tr class=‘ui-table-split‘><td>出借人姓名:</td><td><p>"+hiddenNull(n.cm.lenderName)+"</p></td></tr>";
12   contractTextHtml+="<tr><td>出借人证件类型:</td><td><p>"+hiddenNull(n.cm.lenderIdType)+"</p></td></tr>";
13   contractTextHtml+="<tr class=‘ui-table-split‘><td>出借人证件号:</td><td><p>"+hiddenNull(n.cm.lenderIdNum)+"</p></td></tr>";
14   contractTextHtml+="<tr><td>出借金额:</td><td><p>"+hiddenNull(n.cm.lenderAmount)+"</p></td></tr>";
15   contractTextHtml+="<tr class=‘ui-table-split‘><td>出借人编号:</td><td><p>"+hiddenNull(n.cm.lenderNo)+"</p></td></tr>";
16   contractTextHtml+="<tr><td>出借人银行帐号:</td><td><p>"+hiddenNull(n.cm.lenderBankAccount)+"</p></td></tr>";
17   contractTextHtml+="<tr class=‘ui-table-split‘><td>撮合编号:</td><td><p>"+hiddenNull(n.cm.makeMatchNo)+"</p></td></tr>";
18   contractTextHtml+="</tbody>";
19   contractTextHtml+="</table>";
20   contractTextHtml+="</div>";
21   $("#textList").append(contractTextHtml);
22 });

造成这种问题的根本原因在于拼接html打乱了html原有的层次结构,看不出来哪里是哪里,没有了层次结构的代码,堆在那里就像是一坨垃圾。

el表达式构造html优点是能够保持html原有格式,js构造html优点是速度快省资源,为什么我们不能把二者的优点结合在一起呢?这就是Handlebars.js。

既然要在项目中引入js模版引擎,就必须进行技术选型,严格考核之后,才可以引入,就好像是木桶效应,不能让他成为项目中的短板。

Handlebars.js是一款基于Jquery的插件,以json对象为数据源,支持逻辑判断、循环等操作,同时具有非常好的扩展性,体积60KB左右,经过小菜仔细的分析研究,这是一款不可多得的js模版引擎。

如何引入Handlebars.js?

Jquery插件,第一步当然要引用Jquery啦,然后引用Handlebars.js即可,仅仅需要这两个js文件。

1 <script type="text/javascript" src="script/jquery.js"></script>
2 <script type="text/javascript" src="script/handlebars-1.0.0.beta.6.js"></script>

each-基本循环使用方法。

1 <!DOCTYPE html>
 2 <html>
 3   <head>
 4     <META http-equiv=Content-Type content="text/html; charset=utf-8">
 5     <title>each-基本循环使用方法 - by 杨元</title>
 6   </head>
 7   <body>
 8     <h1>each-基本循环使用方法</h1>
 9     <!--基础html框架-->
10     <table>
11       <thead>
12         <tr>
13           <th>姓名</th>
14           <th>性别</th>
15           <th>年龄</th>
16         </tr>
17       </thead>
18       <tbody id="tableList">
19
20       </tbody>
21     </table>
22
23     <!--插件引用-->
24     <script type="text/javascript" src="script/jquery.js"></script>
25     <script type="text/javascript" src="script/handlebars-1.0.0.beta.6.js"></script>
26
27     <!--Handlebars.js模版-->
28     <!--Handlebars.js模版放在script标签中,保留了html原有层次结构,模版中要写一些操作语句-->
29     <!--id可以用来唯一确定一个模版,type是模版固定的写法-->
30     <script id="table-template" type="text/x-handlebars-template">
31       {{#each student}}
32         <tr>
33           <td>{{name}}</td>
34           <td>{{sex}}</td>
35           <td>{{age}}</td>
36         </tr>
37       {{/each}}
38     </script>
39
40     <!--进行数据处理、html构造-->
41     <script type="text/javascript">
42       $(document).ready(function() {
43         //模拟的json对象
44         var data = {
45                     "student": [
46                         {
47                             "name": "张三",
48                             "sex": "0",
49                             "age": 18
50                         },
51                         {
52                             "name": "李四",
53                             "sex": "0",
54                             "age": 22
55                         },
56                         {
57                             "name": "妞妞",
58                             "sex": "1",
59                             "age": 18
60                         }
61                     ]
62                 };
63
64         //注册一个Handlebars模版,通过id找到某一个模版,获取模版的html框架
65         //$("#table-template").html()是jquery的语法,不懂的童鞋请恶补。。。
66         var myTemplate = Handlebars.compile($("#table-template").html());
67
68         //将json对象用刚刚注册的Handlebars模版封装,得到最终的html,插入到基础table中。
69         $(‘#tableList‘).html(myTemplate(data));
70       });
71     </script>
72   </body>
73 </html>

通过阅读本例,读者已经掌握Handlebars.js一个重要特性:循环。#each可以理解成循环命令,循环的是json对象中的student属性。对于每次循环,都可以读出里边的name、sex、age属性。

js模版引擎handlebars.js实用教程——each-循环中使用this

 1 <!DOCTYPE html>
 2 <html>
 3   <head>
 4     <META http-equiv=Content-Type content="text/html; charset=utf-8">
 5     <title>each-循环中使用this - by 杨元</title>
 6   </head>
 7   <body>
 8     <h1>each-循环中使用this</h1>
 9     <!--基础html框架-->
10     <table>
11       <thead>
12         <tr>
13           <th>姓名</th>
14           <th>性别</th>
15           <th>年龄</th>
16         </tr>
17       </thead>
18       <tbody id="tableList">
19
20       </tbody>
21     </table>
22
23     <!--插件引用-->
24     <script type="text/javascript" src="script/jquery.js"></script>
25     <script type="text/javascript" src="script/handlebars-1.0.0.beta.6.js"></script>
26
27     <!--Handlebars.js模版-->
28     <!--Handlebars.js模版放在script标签中,保留了html原有层次结构,模版中要写一些操作语句-->
29     <!--id可以用来唯一确定一个模版,type是模版固定的写法-->
30     <script id="table-template" type="text/x-handlebars-template">
31       {{#each this}}
32         <tr>
33           <td>{{name}}</td>
34           <td>{{sex}}</td>
35           <td>{{age}}</td>
36         </tr>
37       {{/each}}
38     </script>
39
40     <!--进行数据处理、html构造-->
41     <script type="text/javascript">
42       $(document).ready(function() {
43         //模拟的json对象
44         var data = [
45                         {
46                             "name": "张三",
47                             "sex": "0",
48                             "age": 18
49                         },
50                         {
51                             "name": "李四",
52                             "sex": "0",
53                             "age": 22
54                         },
55                         {
56                             "name": "妞妞",
57                             "sex": "1",
58                             "age": 18
59                         }
60                     ];
61
62         //注册一个Handlebars模版,通过id找到某一个模版,获取模版的html框架
63         //$("#table-template").html()是jquery的语法,不懂的童鞋请恶补。。。
64         var myTemplate = Handlebars.compile($("#table-template").html());
65
66         //将json对象用刚刚注册的Handlebars模版封装,得到最终的html,插入到基础table中。
67         $(‘#tableList‘).html(myTemplate(data));
68       });
69     </script>
70   </body>
71 </html>

很多时候,我们拿到的json对象,本身就是一个list,并不是map,直接就可以遍历,不需要#each student这样指定遍历某个属性。

此时可以用#each this,表示遍历当前对象。

this表示当前上下文,非常灵活

js模版引擎handlebars.js实用教程——each嵌套

 1 <!DOCTYPE html>
 2 <html>
 3   <head>
 4     <META http-equiv=Content-Type content="text/html; charset=utf-8">
 5     <title>each嵌套 - by 杨元</title>
 6   </head>
 7   <body>
 8     <h1>each嵌套</h1>
 9     <!--基础html框架-->
10     <div id="dataList"></div>
11
12     <!--插件引用-->
13     <script type="text/javascript" src="script/jquery.js"></script>
14     <script type="text/javascript" src="script/handlebars-1.0.0.beta.6.js"></script>
15
16     <!--Handlebars.js模版-->
17     <!--Handlebars.js模版放在script标签中,保留了html原有层次结构,模版中要写一些操作语句-->
18     <!--id可以用来唯一确定一个模版,type是模版固定的写法-->
19     <script id="table-template" type="text/x-handlebars-template">
20       {{#each this}}
21         {{#each info}}
22           {{../name}}的{{this}}<br>
23         {{/each}}
24       {{/each}}
25     </script>
26
27     <!--进行数据处理、html构造-->
28     <script type="text/javascript">
29       $(document).ready(function() {
30         //模拟的json对象
31          var data = [{
32                       "name":"张三",
33                       "info":[
34                         "眼睛",
35                         "耳朵",
36                         "鼻子"
37                       ]
38                     },{
39                       "name":"李四",
40                       "info":[
41                         "爸爸",
42                         "妈妈",
43                         "妻子"
44                       ]
45                     }];
46
47         //注册一个Handlebars模版,通过id找到某一个模版,获取模版的html框架
48         //$("#table-template").html()是jquery的语法,不懂的童鞋请恶补。。。
49         var myTemplate = Handlebars.compile($("#table-template").html());
50
51         //将json对象用刚刚注册的Handlebars模版封装,得到最终的html,插入到基础table中。
52         $(‘#dataList‘).html(myTemplate(data));
53       });
54     </script>
55   </body>
56 </html>

循环嵌套在稍微复杂点的页面设计中即会涉及,Handlebars.js完全支持each嵌套,可以在each中使用each。

上边的例子演示了两个关键点:each嵌套的可实现性、如何在each嵌套中读取父each中的数据。

例子很简单,info本身是一个信息列表,是属于某个人的,我们先用each遍历所有的人,然后再遍历每个人的info信息,这样就形成了each嵌套。但是我们想在内层each中获取外层each的数据,达到“谁的什么”这样的显示效果。

显然,如果直接在内层each中使用{{name}},是取不到任何数据的,因为内层each的上下文是info,而name属性在表示人的上下文中。

此时,可以用{{../name}}从内层each获取上一级each的name属性,语法和html的路径表示一样,简单吧?

js模版引擎handlebars.js实用教程——循环中使用索引

 1 <!DOCTYPE html>
 2 <html>
 3   <head>
 4     <META http-equiv=Content-Type content="text/html; charset=utf-8">
 5     <title>关于循环中索引的使用 - by 杨元</title>
 6   </head>
 7   <body>
 8     <h1>关于循环中索引的使</h1>
 9     <!--基础html框架-->
10     <table>
11       <thead>
12         <tr>
13           <th>序号</th>
14           <th>姓名</th>
15           <th>性别</th>
16           <th>年龄</th>
17         </tr>
18       </thead>
19       <tbody id="tableList">
20
21       </tbody>
22     </table>
23
24     <!--插件引用-->
25     <script type="text/javascript" src="script/jquery.js"></script>
26     <!--注意!这个例子用的是新版本handlebars,旧版本不支持-->
27     <script type="text/javascript" src="script/handlebars-v1.3.0.js"></script>
28
29     <!--Handlebars.js模版-->
30     <!--Handlebars.js模版放在script标签中,保留了html原有层次结构,模版中要写一些操作语句-->
31     <!--id可以用来唯一确定一个模版,type是模版固定的写法-->
32     <script id="table-template" type="text/x-handlebars-template">
33       {{#each student}}
34       <tr>
35         <td>{{addOne @index}}</td>
36         <td>{{name}}</td>
37         <td>{{sex}}</td>
38         <td>{{age}}</td>
39       </tr>
40       {{/each}}
41     </script>
42
43     <!--进行数据处理、html构造-->
44     <script type="text/javascript">
45       $(document).ready(function() {
46         //模拟的json对象
47          var data = {
48                       "student": [
49                           {
50                               "name": "张三",
51                               "sex": "0",
52                               "age": 18
53                           },
54                           {
55                               "name": "李四",
56                               "sex": "0",
57                               "age": 22
58                           },
59                           {
60                               "name": "妞妞",
61                               "sex": "1",
62                               "age": 19
63                           }
64                       ]
65                   };
66
67         //注册一个Handlebars模版,通过id找到某一个模版,获取模版的html框架
68         //$("#table-template").html()是jquery的语法,不懂的童鞋请恶补。。。
69         var myTemplate = Handlebars.compile($("#table-template").html());
70
71         //注册一个Handlebars Helper,用来将索引+1,因为默认是从0开始的
72         Handlebars.registerHelper("addOne",function(index,options){
73           return parseInt(index)+1;
74         });
75
76         //将json对象用刚刚注册的Handlebars模版封装,得到最终的html,插入到基础table中。
77         $(‘#tableList‘).html(myTemplate(data));
78       });
79     </script>
80   </body>
81 </html>

序号是指:在循环过程中,当前循环的索引,说白了,就是当前为第几次循环,一般从0开始,Handlebars.js中也是如此。

有什么用呢?最常见的是在显示table的时候,给每行加一个序号,清晰的展示出页面上共有多少条记录,如上边的例子。

除此之外,小菜为了在循环中区分不同的id,恰好需要一个序号,确保id不重复,用过bootstrap的童鞋应该知道,好多事件可以通过id定位,例如Listgroup控件。

废话少说,在Handlebars.js中,可以通过{{@index}}来获取当前的索引,也就是说@index这个变量就代表了当前索引。

在上边的例子里,table的序号从0开始不太好,于是注册了一个Helper,将索引+1。

时间: 2024-10-12 22:27:51

HanderBar的相关文章