本文是一篇 JsRender 的實用入門教程,透過實例講解 tag else 的使用、循環嵌套時存取父級資料等知識點,分享給大家參考。
JsRender 是一款基於 jQuery 的 JavaScript 模板引擎,具有以下特點:簡單直觀、功能強大、可擴展、執行速度快。這些特性看似厲害,但幾乎每個模板引擎都會這麼宣傳。
由於工作需要,作者才接觸到此款模板引擎。使用一段時間後發現它確實強大,但有些地方強大得有點過頭,反倒讓人難以理解。另一方面,JsRender 的官方文檔雖詳細,其他資料卻出奇地少,遇到問題幾乎搜不到結果。加上它有些地方確實不好理解,因此特別整理了一些「最佳實踐」經驗,這些在官方文檔上是找不到的。
程式碼如下:
<script id="testTmpl" type="text/x-jsrender">
<tr>
<td>{{:#index + 1}}</td>
<td>{{:name}}</td>
<td>
{{for family}}
{{!-- 利用 #parent 存取父級 index --}}
<b>{{:#parent.parent.index + 1}}.{{:#index + 1}}</b>
{{!-- 利用 #parent 存取父級資料,父級資料保存在 data 屬性中,#data 相當於 this --}}
{{:#parent.parent.data.name}}的{{:#data}}
{{/for}}
</td>
</tr>
</script>
程式碼如下:
<script id="testTmpl" type="text/x-jsrender">
<tr>
<td>{{:#index + 1}}</td>
<td>{{:name}}</td>
<td>
{{!-- 使用 for 循環時,可在後面添加參數,參數必須以 ~ 開頭,多個參數用空格分隔 --}}
{{!-- 透過參數快取了父級資料,在子循環中存取參數,便能間接存取父級資料 --}}
{{for family ~parentIndex=#index ~parentName=name}}
<b>{{:~parentIndex + 1}}.{{:#index + 1}}</b>
{{:~parentName}}的{{:#data}}
{{/for}}
</td>
</tr>
</script>
資料源與渲染程式碼:把 [{ name: "張三", family: ["爸爸","媽媽","哥哥"] }, { name: "李四", family: ["爺爺","奶奶","叔叔"] }] 透過 $("#testTmpl").render(dataSrouce) 渲染後 append 到 #list 即可。
在自訂標籤中可以使用 {{else ...}} 進行分支,並透過 this.tagCtxs[0].render() 與 this.tagCtxs[1].render() 分別渲染不同分支的內容,同時可透過 this.tagCtx.props 存取附加屬性(如 status)。這種寫法能實現複雜邏輯,但可讀性較差。
更推薦的做法是:用原生的 {{if}} 做分支跳轉,把邏輯判斷交給 helper 處理。透過 $.views.helpers 註冊一個 isShow 函式回傳布林值,再在模板中以 {{if ~isShow(price)}} 呼叫即可。這種方式把「邏輯」與「結構」分離,模板更清晰易讀。
以下以 isShow helper 為例的模板片段:
<td>
{{!-- 利用原生的 if 做分支跳轉,利用 helper 做邏輯處理 --}}
{{if ~isShow(price)}}
{{:price}}
{{else}}
--
{{/if}}
</td>
總的來說,JsRender 靈活但也容易讓人困惑,透過參數快取父級資料、以 helper 取代複雜的自訂標籤,都能讓模板更易於維護。希望本文所述對大家學習 JsRender 有所幫助。