用 Ajax 插入一筆列表項時,最直覺的寫法是把資料與 HTML 標籤拼成一整串,再塞進 ul。資料來自後端或使用者輸入都一樣。問題是,這段拼接放在 JavaScript 檔裡實在難看;若連樣式也寫在 JS 中,資料、結構、樣式就熬成一鍋粥了。更糟的是把最終 HTML 直接由後端吐出,前端幾乎毫無擴充性——改一個樣式都要動後端程式碼。
第一步大家都學過:不要在 JS 裡客製 style,而是在 CSS 中定義好 class,JS 只負責掛上 class。
第二步,就是把 HTML 結構也從 JS 中分離出去——這正是 JavaScript 模板要解決的事。
先在頁面中定義模板:
<script id="list-template" type="text/x-handlebars-template">
<li>{{title}}</li>
</script>
然後在邏輯程式碼中把資料套進模板:
var source = $("#list-template").html(); // 取得模板來源字串
var template = Handlebars.compile(source); // 編譯成模板函式
var context = { title: "This is a todo item" }; // 資料,通常來自 Ajax 或使用者輸入
var html = template(context); // 資料 + 模板 = 新的 HTML
compile 一次,之後反覆傳入不同資料即可,比每次重新拼接字串更有效率。{{#each}}、{{#if}} 等結構,不必在 JS 裡手寫迴圈拼字串。更多語法可參考官方文件:https://handlebarsjs.com/
模板把資料插入 HTML 時,若資料含有 <script> 或 onerror 等內容,就會造成 XSS。Handlebars 的 {{value}} 會自動轉義,而三花括號的 {{{value}}} 則不轉義——除非資料確定是可信的 HTML,否則請一律使用雙花括號版本。
此外,若專案已有前端框架(React、Vue 等),其虛擬 DOM 與自動轉義機制已涵蓋模板需求,不必再另行引入模板庫。