Roo/XTemplate.js
[roojs1] / Roo / XTemplate.js
1 /*
2  * Based on:
3  * Ext JS Library 1.1.1
4  * Copyright(c) 2006-2007, Ext JS, LLC.
5  *
6  * Originally Released Under LGPL - original licence link has changed is not relivant.
7  *
8  * Fork - LGPL
9  * <script type="text/javascript">
10  */
11
12
13 /**
14  * @class Roo.XTemplate
15  * @extends Roo.Template
16  * Provides a template that can have nested templates for loops or conditionals. The syntax is:
17 <pre><code>
18 var t = new Roo.MasterTemplate(
19         '&lt;select name="{name}"&gt;',
20                 '&lt;tpl for="options"&gt;&lt;option value="{value:trim}"&gt;{text:ellipsis(10)}&lt;/option&gt;&lt;/tpl&gt;',
21         '&lt;/select&gt;'
22 );
23  
24 // then append, applying the master template values
25  </code></pre>
26  *
27  * Supported features:
28  *
29  *  Tags:
30  *    {a_variable} - output encoded.
31  *    {a_variable.format:("Y-m-d")} - call a method on the variable
32  *    {a_variable:raw} - unencoded output
33  *    {a_variable:toFixed(1,2)} - Roo.util.Format."toFixed"
34  *    {a_variable:this.method_on_template(...)} - call a method on the template object.
35  *  
36  *  Tpl:
37  *      &lt;tpl for="a_variable or condition.."&gt;&lt;/tpl&gt;
38  *      &lt;tpl if="a_variable or condition"&gt;&lt;/tpl&gt;
39  *      &lt;tpl exec="some javascript"&gt;&lt;/tpl&gt;
40  *
41  *      &lt;tpl for="."&gt;&lt;/tpl&gt; - just iterate the property..
42  *      &lt;tpl for=".."&gt;&lt;/tpl&gt; - iterates with the parent (probably the template) 
43  *      
44  *      
45  */
46 Roo.XTemplate = function()
47 {
48     Roo.XTemplate.superclass.constructor.apply(this, arguments);
49     if (this.html) {
50         this.compile();
51     }
52 };
53
54
55 Roo.extend(Roo.XTemplate, Roo.Template, {
56
57     /**
58      *
59      * basic tag replacing syntax
60      * WORD:WORD()
61      *
62      * // you can fake an object call by doing this
63      *  x.t:(test,tesT) 
64      * 
65      */
66     re : /\{([\w-\.]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
67
68     
69     compile: function()
70     {
71         var s = this.html;
72      
73         s = ['<tpl>', s, '</tpl>'].join('');
74     
75         var re     = /<tpl\b[^>]*>((?:(?=([^<]+))\2|<(?!tpl\b[^>]*>))*?)<\/tpl>/,
76             nameRe = /^<tpl\b[^>]*?for="(.*?)"/,
77             ifRe   = /^<tpl\b[^>]*?if="(.*?)"/,
78             execRe = /^<tpl\b[^>]*?exec="(.*?)"/,
79             m,
80             id     = 0,
81             tpls   = [];
82     
83         while(true == !!(m = s.match(re))){
84             var m2   = m[0].match(nameRe),
85                 m3   = m[0].match(ifRe),
86                 m4   = m[0].match(execRe),
87                 exp  = null, 
88                 fn   = null,
89                 exec = null,
90                 name = m2 && m2[1] ? m2[1] : '';
91                 
92             if (m3) {
93                 // if - puts fn into test..
94                 exp = m3 && m3[1] ? m3[1] : null;
95                 if(exp){
96                    fn = new Function('values', 'parent', 'with(values){ return '+(Roo.util.Format.htmlDecode(exp))+'; }');
97                 }
98             }
99             if (m4) {
100                 // exec - calls a function... returns empty if true is  returned.
101                 exp = m4 && m4[1] ? m4[1] : null;
102                 if(exp){
103                    exec = new Function('values', 'parent', 'with(values){ '+(Roo.util.Format.htmlDecode(exp))+'; }');
104                 }
105             }
106             if (name) {
107                 // for = 
108                 switch(name){
109                     case '.':  name = new Function('values', 'parent', 'with(values){ return values; }'); break;
110                     case '..': name = new Function('values', 'parent', 'with(values){ return parent; }'); break;
111                     default:   name = new Function('values', 'parent', 'with(values){ return '+name+'; }');
112                 }
113             }
114             tpls.push({
115                 id:     id,
116                 target: name,
117                 exec:   exec,
118                 test:   fn,
119                 body:   m[1] || ''
120             });
121             s = s.replace(m[0], '{xtpl'+ id + '}');
122             ++id;
123         }
124         for(var i = tpls.length-1; i >= 0; --i){
125             this.compileTpl(tpls[i]);
126         }
127         this.master = tpls[tpls.length-1];
128         this.tpls = tpls;
129         return this;
130     },
131     
132     applySubTemplate : function(id, values, parent)
133     {
134         var t = this.tpls[id];
135         try { 
136             if(t.test && !t.test.call(this, values, parent)){
137                 return '';
138             }
139             if(t.exec && t.exec.call(this, values, parent)){
140                 return '';
141             }
142             var vs = t.target ? t.target.call(this, values, parent) : values;
143             parent = t.target ? values : parent;
144             if(t.target && vs instanceof Array){
145                 var buf = [];
146                 for(var i = 0, len = vs.length; i < len; i++){
147                     buf[buf.length] = t.compiled.call(this, vs[i], parent);
148                 }
149                 return buf.join('');
150             }
151             return t.compiled.call(this, vs, parent);
152         } catch (e) {
153             Roo.log("Xtemplate.applySubTemplate : Exception thrown");
154             Roo.log(e.toString());
155             Roo.log(e);
156             Roo.log(t);
157             return '';
158         }
159     },
160
161     compileTpl : function(tpl)
162     {
163         var fm = Roo.util.Format;
164         var useF = this.disableFormats !== true;
165         var sep = Roo.isGecko ? "+" : ",";
166         var fn = function(m, name, format, args)
167         {
168             Roo.log(arguments);
169             args = args ? arg.replace(/\\'/g,"'") : args;
170             //["{TEST:(a,b,c)}", "TEST", "", "a,b,c", 0, "{TEST:(a,b,c)}"]
171             if (typeof(format) == 'undefined') {
172                 format= 'htmlEncode';
173             }
174             if (format == 'raw' ) {
175                 format = false;
176             }
177             
178             if(name.substr(0, 4) == 'xtpl'){
179                 return "'"+ sep +'this.applySubTemplate('+name.substr(4)+', values, parent)'+sep+"'";
180             }
181             
182             var v;
183             //if(name.indexOf('.') != -1){
184                 v = name;
185             //}else{
186             //    v = "values['" + name + "']";
187             //}
188             if(format && useF){
189                 
190                 args = args ? ',' + args : "";
191                  
192                 if(format.substr(0, 5) != "this."){
193                     format = "fm." + format + '(';
194                 }else{
195                     format = 'this.call("'+ format.substr(5) + '", ';
196                     args = ", values";
197                 }
198                 return "'"+ sep + format + v + args + ")"+sep+"'";
199             }
200              
201             if (args.length) {
202                 // called with xxyx.yuu:(test,test)
203                 // change to ()
204                 return "'"+ sep + "("+v+" === undefined ? '' : " + v + '(' +  args + "))"+sep+"'";
205             }
206             // raw.. - :raw modifier..
207             return "'"+ sep + "("+v+" === undefined ? '' : " + v + ")"+sep+"'";
208             
209         };
210         var body;
211         // branched to use + in gecko and [].join() in others
212         if(Roo.isGecko){
213             body = "tpl.compiled = function(values, parent){ Roo.log(values); with(values) { return '" +
214                    tpl.body.replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
215                     "';};};";
216         }else{
217             body = ["tpl.compiled = function(values, parent){ Roo.log(values); with (values) { return ['"];
218             body.push(tpl.body.replace(/(\r\n|\n)/g,
219                             '\\n').replace(/'/g, "\\'").replace(this.re, fn));
220             body.push("'].join('');};};");
221             body = body.join('');
222         }
223         
224         Roo.log(body.replace(/\\n/,'\n'));
225        
226         /** eval:var:zzzzzzz */
227         eval(body);
228         
229         return this;
230     },
231
232     applyTemplate : function(values){
233         return this.master.compiled.call(this, values, {});
234         //var s = this.subs;
235     },
236
237     apply : function(){
238         return this.applyTemplate.apply(this, arguments);
239     }
240
241  });
242
243 Roo.XTemplate.from = function(el){
244     el = Roo.getDom(el);
245     return new Roo.XTemplate(el.value || el.innerHTML);
246 };