萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Template (jquery.tmpl) 數據綁定插件完整使用指南

jQuery Template(jquery.tmpl.js)是早期官方推薦的客戶端模板引擎,雖已停止維護(被 JsRender 取代),但大量存量專案仍在使用。本文詳細講解兩種典型綁定模式:模板含表達式綁定後端數據與模板為純 HTML 片段,JS 填充數據。

場景一:模板包含 ${表達式},直接綁定後端 JSON 數據

1. 目標容器(渲染後插入處)

<dl class="box_pannel_content_filled_border none" id="gvRecCalls">
    <dd class="bg_blue">
        <p class="width_level_half_2 fl nopitch"></p>
        <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" id="pAmount">金額($)</p>
        <p class="width_level_half_4 bold fl">時長</p>
        <p class="width_level_half_10 bold fl">區域</p>
        <p class="width_level_half_4 bold fl nopitch" name="pCDRHeader">CDR ID</p>
        <p class="width_level_half_2 fl none" name="pSelectCbHeader"></p>
        <p class="width_level_half_2 fr none" name="pDeleteCbHeader"></p>
    </dd>
</dl>

2. 模板定義(含 ${} 表達式、三元運算、函數調用)

<dl id="RecCallsTemplate">
<dd>
    <p class="center width_level_half_2 fl nopitch">
        <b class="${CallMode == 1 ? 'icon_call_in' : 'icon_call_out'}"></b>
    </p>
    <span class="width_level_half_5 fl"><span style="color:#FF0000;">${CalledStationId}</span></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_4 fl"><span style="color:#FF0000;">${CSSCommonJS.GetTimeFormatString(RevenueTime)}</span></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>
    <span class="fl none" name="pDeleteCbHeader">
        <button class="crm_btn norm" id="btDelete"><b>刪除</b></button>
    </span>
</dd>
</dl>

3. 綁定渲染調用

<script src="Scripts/jquery.tmpl.js" type="text/javascript"></script>
function RenderTemplatefunction(container, template, data) {
    $(template).tmpl(data).appendTo(container); // 核心 API
}

// 假設 result.CdrData 為陣列 [{CallMode:1, CalledStationId:'...', ...}, ...]
CSSCommonJS.RenderTemplatefunction(
    $(t.panelID).find("#gvRecCalls"), 
    $(t.panelID).find("#RecCallsTemplate"), 
    result.CdrData
);

場景二:模板為純 HTML 片段(無表達式),JS 遍歷數據手動填充

適用於「許願牆」等需對每項綁定事件、動態計算屬性的場景。

模板(隱藏)

<div id="ItemTemplate" style="display: none;">
    <dd>
        <div class="items">
            <div class="bg">
                <div class="info"><a href="#" id="btnTitle"><span id="item_title"></span></a></div>
                <div class="k"></div>
                <div class="person" id="item_person"></div>
                <div class="date" id="item_date"></div>
            </div>
        </div>
    </dd>
</div>

渲染邏輯:渲染後遍歷綁定事件/填充字段

$.get("control/controler.ashx?t=" + new Date(), { type: 'heartwall', date: new Date() }, function (data) {
    var jsonData = eval("(" + data + ")"); // 老式解析,現代用 JSON.parse
    RenderTemplatefunction($("#ItemList"), $("#ItemTemplate"), jsonData.table);
    
    // 渲染完成後,逐項查找子元素填充內容、綁定事件
    $("#ItemList").children("dd").each(function (index) {
        var tTr = this;
        var tmp_title = $(tTr).find("#item_title");
        var tmp_person = $(tTr).find("#item_person");
        // tmp_title.text(jsonData.table[index].title);
        // tmp_person.text(jsonData.table[index].author);
        // $(tTr).find("#btnTitle").click(function(){ ... });
    });
});

遷移建議:從 jquery.tmpl 升級至現代方案

  • JsRender:jquery.tmpl 官方繼任者,語法相似 `{{:field}}`,性能更強、支援預編譯、無 jQuery 依賴可選。
  • Vue/React/Angular/Svelte:組件化框架內置模板系統,聲明式綁定、響應式更新,無需手動 .tmpl()。
  • 輕量替代:template7、doT.js、art-template、eta 等純 JS 模板引擎,體積 <1kb,語法強大。

理解 jquery.tmpl 的 `${}` 表達式語法與 `.tmpl(data)` 渲染流程,有助於維護老代碼並平滑遷移至現代技術棧。

copyright © 萬盛學電腦網 all rights reserved