jQuery Tmpl(jquery-tmpl)曾是 jQuery 官方推薦的客戶端模板引擎,雖已停止維護(被 JsRender 取代),但在存量項目中仍廣泛存在。本文通過完整實例演示從引入腳本、編寫模板、AJAX 獲取數據到渲染落地的標準流程,幫助維護舊項目的開發者快速上手。
<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
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班" } }
];
<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}} 等標籤支持邏輯控制。$.ajax({
url: "/api/teachers",
dataType: "json",
success: function(data) {
// 方式一:直接渲染到目標容器
$("#teacherTmpl").tmpl(data).appendTo("#teacherTable tbody");
// 方式二:獲取渲染後 HTML 字符串(如需進一步處理)
// var html = $("#teacherTmpl").tmpl(data).toString();
}
});
<!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"}} | 包裝器模板 | 佈局復用 |
jQuery Tmpl 於 2011 年停止更新,**新項目請勿使用**。推薦遷移路徑:
`<li>${name}</li>` + map/join 即可無依賴完成。理解 jQuery Tmpl 的工作原理(模板編譯為渲染函數、數據綁定、DOM 插入),有助於理解現代框架虛擬 DOM、編譯時優化的本質,也是前端模板演進史的重要一環。