Handlebars 是一個 JavaScript 頁面模板庫,用「 Mustache 風格」的 {{ }} 語法幫你把資料填進 HTML 骨架裡,大幅減少字串拼接。以下是最小可行範例。
<script src="js/jquery1.11.min.js"></script> <script src="js/handlebars-v3.0.0.js"></script>
常見做法是把模板放在一個 display:none 的容器裡,用 {{變數名稱}} 標記要填入資料的位置:
<div id="tt" style="display:none">
<div class="entry">
<h1>{{title}}</h1>
<div class="body">{{body}}</div>
</div>
</div>
var source = $("#tt").html(); // 取出模板字串
var template = Handlebars.compile(source); // 編譯成函式
var data = { title: "My New Post", body: "This is my first post!" };
var result = template(data); // 把資料填進模板
console.log(result);
$('#tt').before(result); // 輸出到頁面
Handlebars.compile() 會把模板字串轉成一個可重複呼叫的函式。若同一份模板要渲染大量資料(例如列表),只編譯一次再傳入不同資料,比每次重新解析字串快得多。
var listTemplate = Handlebars.compile("<li>{{name}}</li>");
var html = list.map(function(item){ return listTemplate(item); }).join('');
$("ul").html(html);
{{ }} 會自動做 HTML 轉義,能避免 XSS;若內容本身是安全的 HTML 且需要原樣輸出,才用三括號 {{{ }}}。#each、#if、#unless 等內建 helper,就能處理列表與條件判斷,不必手動迴圈。<script type="text/x-handlebars-template"> 標籤裡,比藏在 div 中語意更清楚,也不會被瀏覽器當成內容渲染。想更深入的話,可以參考官方文件與 Getting Started with Handlebars.js 這類入門文章,把 helper 與 partial 機制摸熟,就能應付絕大多數頁面渲染場景。