移動端基於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交互 « 張鑫旭-鑫空間-鑫生活
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模板引擎實例應用》。