這份提案探討如何在 jQuery 核心中加入模板支援。核心目標是提供一個名為 render() 的新方法,讓你能用一段 HTML 當模板,把 JavaScript 物件或物件陣列渲染成畫面。
提案的用意是讓插件開發者能用一致的方式宣告與渲染模板。這對雙方都有好處:
提案分兩部分:先回顧現有的模板方案,再說明建議如何將模板宣告與渲染加入 jQuery 核心。
John Resig 的微型模板引擎非常小(未壓縮僅約 2 KB),卻已經涵蓋了渲染模板的核心能力。以下是用它顯示單一 JavaScript 產品物件的例子。
<script src="../jquery-1.4.1.js" type="text/javascript"></script>
<script src="MicroTemplating.js" type="text/javascript"></script>
<script type="text/javascript">
var product = { name: "Laptop", price: 788.67 };
$(showProduct);
function showProduct() {
$("#results").html(tmpl("productTemplate", product));
}
function formatPrice(price) {
return "$" + price;
}
</script>
tmpl() 用 product 模板與 product 物件生成字串,結果被指派給 id 為 results 的 div 的 innerHTML。
模板本身定義在頁面 body 的 script 標籤裡:
<script type="text/html" id="productTemplate">
Product Name: <%= name %>
<br />
Product Price: <%= formatPrice(price) %>
</script>
<div id="results"></div>
有兩個細節值得注意。第一,script 的 type 刻意設為 text/html——瀏覽器會忽略這種 script 標籤裡的內容,於是它就變成了一個存放字串的容器,這是很常見的模板掛載技巧。第二,模板裡除了屬性運算式,還能直接呼叫 JavaScript 函式(此處是 formatPrice()),等於把格式化邏輯留在模板層,不必事先處理好資料。
要渲染 product 陣列,做法是先解析模板取得函式,再逐一套用:
function showProducts() {
// 解析模板
var template = tmpl("productTemplate");
// 逐一走訪 products
var results = '';
for (var i = 0; i < products.length; i++) {
results += template(products[i]);
}
// 輸出結果
$("#results").html(results);
}
tmpl() 支援 currying(柯里化,可上網查閱相關資料):若不傳入資料,它會回傳一個代表已解析模板的 JavaScript 函式,之後便能重複套用在不同物件上。這正是上面的程式能先解析一次、再對每個 product 呼叫的原因。
這個模式看似簡單,卻點出了後續 jQuery Templates 正式功能的雛形:模板是一次性的、資料是多次的,兩者分離之後,列表渲染才不會變成一堆字串拼接。