jquery.tmpl 是 jQuery 早期很受歡迎的模板外掛,能用類似 ${ } 的語法把後端資料綁定到 HTML 模板上,大幅減少手動拼接字串的麻煩。以下整理三種常見用法。
先指定目標容器,例如通話記錄頁:
<dl class="box_pannel_content_filled_border none" id="gvRecCalls">
<dd class="bg_blue">
<p class="width_level_half_5 bold fl">被叫號碼</p>
<p class="width_level_half_5 bold fl">主叫號碼</p>
<p class="width_level_half_6 bold fl">起始時間</p>
<p class="width_level_half_4 bold fl">金額($)</p>
</dd>
</dl>
接著撰寫模板,用 ${ } 標記資料佔位,還能寫運算式與呼叫函式:
<dl id="RecCallsTemplate" >
<dd >
<span class="width_level_half_5 fl">${CalledStationId}</span>
<span class="width_level_half_5 fl">${CallingStationId.substr(CallingStationId.indexOf("*") + 1)}</span>
<span class="width_level_half_6 fl" id="Start_time" >${StartTime}</span>
<span class="width_level_half_4 fl">${CSSCommonJS.ChangeDecimal(Revenue,3)}</span>
<span class="width_level_half_10 fl">${Location} </span>
<span class="width_level_half_4 fl nopitch" name="pCDRHeader" >${CdrId}</span>
<p class="right width_level_half_2 fr none" name="pSelectCbHeader">
<input type="checkbox" name="cbSelect" class="label" /></p>
</dd>
</dl>
最後在後台呼叫渲染:
<script src="Scripts/jquery.tmpl.js" type="text/javascript"></script>
function RenderTemplatefunction(container, template, data) {
$(template).tmpl(data).appendTo(container); // 原始方法
};
CSSCommonJS.RenderTemplatefunction($(t.panelID).find("#gvRecCalls"), $(t.panelID).find("#RecCallsTemplate"), result.CdrData);
有時模板只是純 HTML 骨架,資料在後台用 $.tmplItem() 取得每筆資料物件後逐一填充並綁定事件:
// 獲取許願牆數據
$.get("control/controler.ashx?t=" + new Date(), { type: 'heartwall', date: new Date() }, function (data) {
var jsonData = eval("(" + data + ")");
RenderTemplatefunction($("#ItemList"), $("#ItemTemplate"), jsonData.table);
$("#ItemList").children("dd").each(function (index) {
var tTr = this;
var selectedItem = $.tmplItem(this); // 取得該筆資料
var tmp_title = $(tTr).find("#item_title");
tmp_title.html(selectedItem.data.title); // 綁定資料
// …綁定其他欄位與事件
});
});
當一筆資料裡有多個陣列(例如帳單含「消費明細、回饋、儲值」),可用 {{tmpl(子陣列, "#子模板")}} 把各子陣列分別綁到對應子模板:
<div id="ProductBillingTemplate" class="none">
<dl class="box_pannel_content_filled_special">
<dd>
<span class="width_level_9 fl"><b class="bold" id="bComboName"></b> <b id="bTel"></b></span>
</dd>
{{tmpl(BillTransactions) "#BillingDetailDateTemplate"}}
{{tmpl(RebateInstances) "#BillingDetailDateTemplate"}}
{{tmpl(TopUpDetails) "#BillingDetailDateTemplate"}}
</dl>
</div>
子模板可以是三個資料來源共用的,當屬性名稱不同時,可用 typeof 做判斷:
<div id="BillingDetailDateTemplate" class="none">
<dd>
<p>${(typeof(Name) == "undefined" ? Type : Name) + ":"}</p>
<span id="spamount">${CSSCommonJS.ChangeDecimal((typeof(InitialAmount) == "undefined" ? Amount : InitialAmount), 2)}</span>
<span id="spdescription">${Description}</span>
</dd>
</div>
嵌套綁定由模板引擎自動完成:外層模板透過 {{tmpl}} 把每個子陣列丟給共用的子模板,逐一渲染。掌握「指定容器 → 撰寫模板 → 呼叫 tmpl 渲染」這條主線,就能靈活應付各種資料綁定場景。