首页 > 嗟来之食 > 移动端基于HTML模板和JSON数据的JavaScript交互 – 飞鸿影~ –
2016
07-18

移动端基于HTML模板和JSON数据的JavaScript交互 – 飞鸿影~ –

写本文之前,我正在做一个基于Tab页的订单中心:

每点击一个TAB标签,会请求对应状态的订单列表。之前的项目,我会在js里使用 + 连接符连接多个html内容:

var html = '';
html += '<div class="empty-list">' +
'<div class="icon icon-box"></div>'+
'<div>还没有订单</div>'+
'</div>';

Html内容少点还好,但是当内容多起来的时候,再使用这种方式,以后维护起来不方便,也影响美观,可阅读性差。

突然想起来PHP模板的相关知识,那么应该也有类似JavaScript模板一说。由于为了快速使用在项目上,就去网上找了找。还真有:
基于HTML模板和JSON数据的JavaScript交互 http://www.zhangxinxu.com/wordpress/2012/09/javascript-html-json-template/

看了下文章,使用起来还是蛮简单的:
1、准备好html模板

<textarea class="js-order-tmp" style="display:none;">
<!–goods-block–>
<div class="block m-s-order">
<div class="block-item block-news">
<a href="<?php echo site_url('order/detail/'. '$id$')?>" class="dis-block external">
<div class="item-img">
<img src="$thumb$"/>
</div>
<div class="item-intro">
<div class="sub-l">
<p class="t-order-num">订单号:$order_num$</p>
<p class="t-name">收件人:$cus_name$</p>
<p class="t-date">$create_time$</p>
</div>
<div class="sub-r">
<p class="t-expand"><span class="icon icon-right"></span></p>
<p class="t-flag">$flag_name$</p>
</div>
</div>
<div class="clear"></div>
</a>
</div>
</div>
<!–/goods-block–>
</textarea>

<textarea class="js-no-order-tmp" style="display:none;">
<!– no order –>
<div class="empty-list">
<div class="icon icon-box"></div>
<div>还没有订单</div>
</div>
<!– /no order –>
</textarea>

其中变量部分全部用两个美元符号 $ 表示。
2、模板方法很简单,直接写一个基于字符串原型的扩展方法,确保全局可用:

String.prototype.temp = function(obj) {
return this.replace(/\$\w+\$/gi, function(matchs) {
var returns = obj[matchs.replace(/\$/g, "")];
return (returns + "") == "undefined"? "": returns;
});
};

主要使用到了正则知识。

3、准备json数据:

{
"ecd": 0,
"msg": "成功",
"result": [{
"id": "32",
"order_num": "test-001",
"title": "test",
"thumb": "http:\/\/40DA1265-40F6-D622-8BA5-04BA0AF72573.jpg",
"item_id": "21",
"price": "0.11",
"cus_name": "test",
"cus_tel": "10086",
"cus_address": "北京 北京海淀区",
"flag": "5",
"create_time": "20160329115544",
"update_time": "20160330120001",
"flag_name": "订单已取消"
}],
"locate": ""
}

4、使用ajax请求并显示数据

$.progress_show('正在努力加载中');

$.ajax({
url: site_url + 'api/order/getAll/' + status,
type: 'get',
dataType: 'json',
error: doAjax.error,
success: function (response) {
$.progress_hide();

if (response.ecd == '0') {
var htmlList = '', htmlTemp = $("textarea.js-order-tmp").val();

if(typeof response.result === 'undefined'){
htmlList = $("textarea.js-no-order-tmp").val();
}else{
$.each(response.result, function(i,el) {
htmlList += htmlTemp.temp(el);
});
}

$('.js-status-' + status).empty().append(htmlList);

return true;
} else {
return $.alert(response.msg);
}
},
});

这里的部分方法没有给出,大家知道流程、原理即可。通过点击TAB标签,就可以显示数据了:

非常感谢博主张鑫旭提供的思路及文章!详情可阅读:
基于HTML模板和JSON数据的JavaScript交互 &laquo; 张鑫旭-鑫空间-鑫生活http://www.zhangxinxu.com/wordpress/2012/09/javascript-html-json-template/

更新:
使用laytpl模板引擎
在使用过程发现,对于复杂的json数据, String.prototype.temp 就不适用了。例如

<div>
<h1>$title$</h1>
<ul>
<li>姓名:$list.name$</li>
<li>城市:$list.city$</li>
</ul>
</div>

var data = {
title: 'test',
desc: {name: 'Dem', city: '北京'},
};

其中 $title$ 是正常渲染的,而姓名和城市就显示不出来了。这就需要去优化 String.prototype.temp 方法了。

这里为了快速的应用于项目上,使用了网上已经存在的JavaScript模板引擎:laytpl。大小1.77kb,足够mini了。
用法很简单,引入 laytpl.js 后,只要把前文讲到的稍微改改就行了:
模板:

<div>
<h1>{{d.title}}</h1>
<ul>
<li>姓名:{{d.list.name}}</li>
<li>城市:{{d.list.city}}</li>
</ul>
</div>

需要将两个美元符号 $$ 改成花括号 {{ }} ,另外前面加个 d. 。
js:

$.each(response.result, function(i,el) {

//htmlList += htmlTemp.temp(el); //htmlTemp为模板内容,el为遍历的数据对象,htmlList为渲染后的内容

//改为:
htmlList += laytpl(htmlTemp).render(el);
});$('.js-status-' + status).empty().append(htmlList);

ok了。想了解更多去其官网看吧:
laytpl官网 – 精妙的JavaScript模板引擎http://laytpl.layui.com/

总结
1、String.prototype.temp方法让我们了解了js模板实现的原理,打开了了解js模板引擎的大门;
2、对于简单的数据展示,String.prototype.temp还是可以用的;
3、复杂的数据结构,如果有时间和能力去优化String.prototype.temp方法也是可以的;或者直接使用第三方的laytpl、artTemplate、doT、baiduTemplate、kissyTemplate等模板引擎。

如果想了解如何使用laytpl、artTemplate、doT、baiduTemplate等模板引擎,请查看我的另外一篇文章:《JavaScript模板引擎实例应用》。

最后编辑:
作者:
这个作者貌似有点懒,什么都没有留下。

留下一个回复