Ext 的 Template 元件可以傳入 JSON 資料進行模板替換,寫起來清爽。但當資料只有一層時一切美好,遇到巢狀結構就卡住了。本文示範如何用最少的程式碼打通這一關。
var t = new Ext.Template(
'<div name="{id}">',
'<span class="{cls}">{name:trim} {value:ellipsis(10)}</span>',
'</div>'
);
t.append('some-element', { id: 'myid', cls: 'myclass', name: 'foo', value: 'bar' });
var t = new Ext.Template(
'<div name="{id}">',
'<span class="{cls}">{name} {value}</span>',
'</div>'
);
var dt = t.apply({ id: 'myid', cls: 'myclass', name: 'foo', value: 'bar' });
alert(dt);
執行後會彈出 <div name="myid"><span class="myclass">foo bar</span></div>,代表替換成功。
如果傳入的資料長這樣:
{ id: 'myid', cls: { o: 'myclass' }, name: 'foo', value: 'bar' }
我們希望模板中的 cls 位置被 cls.o 的值(也就是 myclass)取代。直覺會寫成 {cls.o}——但試了就知道完全無效,不會有任何替換。
原因在于 Template 的匹配機制:它拿大括號內、冒號之前的那段字串,直接與 JSON 物件的頂層鍵相比對。程式中並不存在名為 cls.o 的鍵,自然比對不到。
好消息是 Template 支援在佔位符後面接上處理函式,語法是以冒號加上函式名稱表示。我們只要自己定義這個函式即可:
var t = new Ext.Template(
'<div name="{id}">',
'<span class="{cls:this.parseJSON}">{name} {value}</span>',
'</div>'
);
t.parseJSON = function (data) {
return data.o;
};
var dt = t.apply({ id: 'myid', cls: { o: 'myclass' }, name: 'foo', value: 'bar' });
alert(dt);
{cls:this.parseJSON} 的意思是:先取出頂層的 cls,把它的值當成參數傳給 parseJSON,再把回傳結果放進模板。由於 cls 是一個物件,我們在函式中直接取它的 o 屬性,就得到了 myclass。
這套技巧可以延伸處理更複雜的情況:多層嵌套時讓函式接受整個資料物件再自行深入取值,或是把格式化邏輯(日期、金額、狀態對照)集中到同一支函式裡。相比在模板中塞入 Logic-less 語法,這種做法更直觀,也更容易測試。