基于HTML模板与JSON数据的JavaScript动态渲染方案

作者:小圆点

时间:2026-10-30

浏览:434

本文介绍一种基于HTML模板和JSON数据的JavaScript交互方案。通过定义包含占位符的HTML模板,利用字符串原型扩展方法实现正则替换,将JSON数据动态注入页面。该方案解决了传统字符串拼接方式在内容增多时维护困难、可读性差的问题,适用于移动端订单中心等场景,通过Ajax获取数据后快速生成DOM结构。

文章目录

HTML模板与JSON交互方案概述

在开发基于Tab页签的订单中心项目时,需要实现动态数据加载。

以往的做法是在JavaScript代码中直接使用加号连接符拼接多个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/

经过阅读,发现该方案的使用流程相对简单,主要包含以下几个步骤。

HTML模板定义与变量占位

第一步是准备好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> 

在模板中,所有需要动态替换的变量部分统一使用 $$variate$$ 的形式进行表示。

字符串原型扩展与正则替换实现

第二步是编写模板处理方法,通过扩展字符串原型来确保该方法在全局可用。


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

该方法的核心实现依赖于正则表达式进行匹配和替换。

JSON数据准备与Ajax动态渲染

第三步是准备用于渲染的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": ""
} 

第四步是通过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标签触发Ajax请求,即可动态显示对应的数据列表。

以上介绍了基于HTML模板和JSON数据的JavaScript交互方案,希望能为移动端开发提供参考。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章