萬盛學電腦網

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

jQuery Tmpl 模板引擎快速入門:從引入到渲染的完整流程

jQuery Tmpl(jquery-tmpl)曾是 jQuery 官方推薦的客戶端模板引擎,雖已停止維護(被 JsRender 取代),但在存量項目中仍廣泛存在。本文通過完整實例演示從引入腳本、編寫模板、AJAX 獲取數據到渲染落地的標準流程,幫助維護舊項目的開發者快速上手。

1. 引入腳本

<script src="jquery.min.js"></script>
<script src="jquery.tmpl.min.js"></script> <!-- 官方插件 -->

或使用 CDN:https://cdn.jsdelivr.net/npm/jquery-tmpl@1.0.0/jquery.tmpl.min.js

2. 準備數據(模擬後端返回 JSON)

var teachers = [
    { tId: 1, tName: "張三", tAge: 14, tClass: 1, TeachClass: { cId: 1, cName: "1班" } },
    { tId: 2, tName: "李四", tAge: 25, tClass: 1, TeachClass: { cId: 1, cName: "1班" } },
    { tId: 4, tName: "趙六", tAge: 16, tClass: 2, TeachClass: { cId: 2, cName: "2班" } }
];

3. 編寫模板(<script type="text/x-jquery-tmpl">)

<script id="teacherTmpl" type="text/x-jquery-tmpl">
<tr>
    <td>${tId}</td>
    <td>${tName}</td>
    <td>${tAge}</td>
    <td>${TeachClass.cName}</td>
    <td><a href="/edit/${tId}">編輯</a></td>
</tr>
</script>
  • ${field}:輸出字段值(HTML 編碼)。
  • {{html field}}:輸出原始 HTML(慎用,防 XSS)。
  • {{if condition}}、{{else}}、{{each}} 等標籤支持邏輯控制。

4. 渲染模板

$.ajax({
    url: "/api/teachers",
    dataType: "json",
    success: function(data) {
        // 方式一:直接渲染到目標容器
        $("#teacherTmpl").tmpl(data).appendTo("#teacherTable tbody");

        // 方式二:獲取渲染後 HTML 字符串(如需進一步處理)
        // var html = $("#teacherTmpl").tmpl(data).toString();
    }
});

5. 完整頁面示例

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>jQuery Tmpl Demo</title>
    <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/jquery-tmpl@1.0.0/jquery.tmpl.min.js"></script>
</head>
<body>
<table id="teacherTable" border="1">
    <thead><tr><th>ID</th><th>姓名</th><th>年齡</th><th>班級</th><th>操作</th></tr></thead>
    <tbody></tbody>
</table>

<script id="teacherTmpl" type="text/x-jquery-tmpl">
<tr>
    <td>${tId}</td>
    <td>${tName}</td>
    <td>${tAge}</td>
    <td>${TeachClass.cName}</td>
    <td><button onclick="edit(${tId})">編輯</button></td>
</tr>
</script>

<script>
$(function() {
    var mockData = [
        { tId: 1, tName: "張三", tAge: 14, tClass: 1, TeachClass: { cId: 1, cName: "1班" } },
        { tId: 2, tName: "李四", tAge: 25, tClass: 1, TeachClass: { cId: 1, cName: "1班" } },
        { tId: 4, tName: "趙六", tAge: 16, tClass: 2, TeachClass: { cId: 2, cName: "2班" } }
    ];
    $("#teacherTmpl").tmpl(mockData).appendTo("#teacherTable tbody");
});
</script>
</body>
</html>

進階用法速覽

語法說明示例
{{if condition}}條件渲染{{if tAge > 18}}成年{{else}}未成年{{/if}}
{{each list}}遍歷數組/對象{{each tags}}<span>${$value}</span>{{/each}}
{{tmpl "subTmpl"}}嵌套子模板複雜結構拆分
${$index}當前索引生成序號
{{wrap "wrapperTmpl"}}包裝器模板佈局復用

遷移建議:JsRender / 現代框架

jQuery Tmpl 於 2011 年停止更新,**新項目請勿使用**。推薦遷移路徑:

  1. JsRender:同作者 Boris Moore 開發,語法兼容,性能更強,支持預編譯、流式渲染、無 jQuery 依賴。
  2. Vue / React / Svelte:組件化框架徹底解決模板與狀態管理耦合問題,長期收益最高。
  3. 原生 Template Literals:簡單場景下 `<li>${name}</li>` + map/join 即可無依賴完成。

理解 jQuery Tmpl 的工作原理(模板編譯為渲染函數、數據綁定、DOM 插入),有助於理解現代框架虛擬 DOM、編譯時優化的本質,也是前端模板演進史的重要一環。

copyright © 萬盛學電腦網 all rights reserved