1 Ext.data.JsonP.Ext_XTemplate({
3 "name": "Ext.XTemplate",
4 "doc": "<p>A template class that supports advanced functionality like:<div class=\"mdetail-params\"><ul>\n<li>Autofilling arrays using templates and sub-templates</li>\n<li>Conditional processing with basic comparison operators</li>\n<li>Basic math function support</li>\n<li>Execute arbitrary inline code with special built-in template variables</li>\n<li>Custom member functions</li>\n<li>Many special tags and built-in operators that aren't defined as part of\nthe API, but are supported in the templates that can be created</li>\n</ul></div></p>\n\n\n<p>XTemplate provides the templating mechanism built into:<div class=\"mdetail-params\"><ul>\n<li><a href=\"#/api/Ext.view.View\" rel=\"Ext.view.View\" class=\"docClass\">Ext.view.View</a></li>\n</ul></div></p>\n\n\n<p>The <a href=\"#/api/Ext.Template\" rel=\"Ext.Template\" class=\"docClass\">Ext.Template</a> describes\nthe acceptable parameters to pass to the constructor. The following\nexamples demonstrate all of the supported features.</p></p>\n\n<div class=\"mdetail-params\"><ul>\n\n<li><b><u>Sample Data</u></b>\n<div class=\"sub-desc\">\n<p>This is the data object used for reference in each code example:</p>\n<pre><code>var data = {\nname: 'Tommy Maintz',\ntitle: 'Lead Developer',\ncompany: 'Sencha Inc.',\nemail: 'tommy@sencha.com',\naddress: '5 Cups Drive',\ncity: 'Palo Alto',\nstate: 'CA',\nzip: '44102',\ndrinks: ['Coffee', 'Soda', 'Water'],\nkids: [{\n name: 'Joshua',\n age:3\n },{\n name: 'Matthew',\n age:2\n },{\n name: 'Solomon',\n age:0\n}]\n};\n </code></pre>\n</div>\n</li>\n\n\n<li><b><u>Auto filling of arrays</u></b>\n<div class=\"sub-desc\">\n<p>The <b><tt>tpl</tt></b> tag and the <b><tt>for</tt></b> operator are used\nto process the provided data object:\n<ul>\n<li>If the value specified in <tt>for</tt> is an array, it will auto-fill,\nrepeating the template block inside the <tt>tpl</tt> tag for each item in the\narray.</li>\n<li>If <tt>for=\".\"</tt> is specified, the data object provided is examined.</li>\n<li>While processing an array, the special variable <tt>{#}</tt>\nwill provide the current array index + 1 (starts at 1, not 0).</li>\n</ul>\n</p>\n<pre><code><tpl <b>for</b>=\".\">...</tpl> // loop through array at root node\n<tpl <b>for</b>=\"foo\">...</tpl> // loop through array at foo node\n<tpl <b>for</b>=\"foo.bar\">...</tpl> // loop through array at foo.bar node\n </code></pre>\nUsing the sample data above:\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Kids: ',\n '<tpl <b>for</b>=\".\">', // process the data.kids node\n '<p>{#}. {name}</p>', // use current array index to autonumber\n '</tpl></p>'\n);\ntpl.overwrite(panel.body, data.kids); // pass the kids property of the data object\n </code></pre>\n<p>An example illustrating how the <b><tt>for</tt></b> property can be leveraged\nto access specified members of the provided data object to populate the template:</p>\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Title: {title}</p>',\n '<p>Company: {company}</p>',\n '<p>Kids: ',\n '<tpl <b>for=\"kids\"</b>>', // interrogate the kids property within the data\n '<p>{name}</p>',\n '</tpl></p>'\n);\ntpl.overwrite(panel.body, data); // pass the root node of the data object\n </code></pre>\n<p>Flat arrays that contain values (and not objects) can be auto-rendered\nusing the special <b><tt>{.}</tt></b> variable inside a loop. This variable\nwill represent the value of the array at the current index:</p>\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>{name}\\'s favorite beverages:</p>',\n '<tpl for=\"drinks\">',\n '<div> - {.}</div>',\n '</tpl>'\n);\ntpl.overwrite(panel.body, data);\n </code></pre>\n<p>When processing a sub-template, for example while looping through a child array,\nyou can access the parent object's members via the <b><tt>parent</tt></b> object:</p>\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Kids: ',\n '<tpl for=\"kids\">',\n '<tpl if=\"age &gt; 1\">',\n '<p>{name}</p>',\n '<p>Dad: {<b>parent</b>.name}</p>',\n '</tpl>',\n '</tpl></p>'\n);\ntpl.overwrite(panel.body, data);\n </code></pre>\n</div>\n</li>\n\n\n<li><b><u>Conditional processing with basic comparison operators</u></b>\n<div class=\"sub-desc\">\n<p>The <b><tt>tpl</tt></b> tag and the <b><tt>if</tt></b> operator are used\nto provide conditional checks for deciding whether or not to render specific\nparts of the template. Notes:<div class=\"sub-desc\"><ul>\n<li>Double quotes must be encoded if used within the conditional</li>\n<li>There is no <tt>else</tt> operator — if needed, two opposite\n<tt>if</tt> statements should be used.</li>\n</ul></div>\n<pre><code><tpl if=\"age > 1 && age < 10\">Child</tpl>\n<tpl if=\"age >= 10 && age < 18\">Teenager</tpl>\n<tpl <b>if</b>=\"this.isGirl(name)\">...</tpl>\n<tpl <b>if</b>=\"id==\\'download\\'\">...</tpl>\n<tpl <b>if</b>=\"needsIcon\"><img src=\"{icon}\" class=\"{iconCls}\"/></tpl>\n// no good:\n<tpl if=\"name == \"Tommy\"\">Hello</tpl>\n// encode " if it is part of the condition, e.g.\n<tpl if=\"name == &quot;Tommy&quot;\">Hello</tpl>\n</code></pre>\nUsing the sample data above:\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Kids: ',\n '<tpl for=\"kids\">',\n '<tpl if=\"age &gt; 1\">',\n '<p>{name}</p>',\n '</tpl>',\n '</tpl></p>'\n);\ntpl.overwrite(panel.body, data);\n </code></pre>\n</div>\n</li>\n\n\n<li><b><u>Basic math support</u></b>\n<div class=\"sub-desc\">\n<p>The following basic math operators may be applied directly on numeric\ndata values:</p>\n<pre>+ - * /\n</pre>\nFor example:\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Kids: ',\n '<tpl for=\"kids\">',\n '<tpl if=\"age &gt; 1\">', // <-- Note that the > is encoded\n '<p>{#}: {name}</p>', // <-- Auto-number each item\n '<p>In 5 Years: {age+5}</p>', // <-- Basic math\n '<p>Dad: {parent.name}</p>',\n '</tpl>',\n '</tpl></p>'\n);\ntpl.overwrite(panel.body, data);\n </code></pre>\n</div>\n</li>\n\n\n<li><b><u>Execute arbitrary inline code with special built-in template variables</u></b>\n<div class=\"sub-desc\">\n<p>Anything between <code>{[ ... ]}</code> is considered code to be executed\nin the scope of the template. There are some special variables available in that code:\n<ul>\n<li><b><tt>values</tt></b>: The values in the current scope. If you are using\nscope changing sub-templates, you can change what <tt>values</tt> is.</li>\n<li><b><tt>parent</tt></b>: The scope (values) of the ancestor template.</li>\n<li><b><tt>xindex</tt></b>: If you are in a looping template, the index of the\nloop you are in (1-based).</li>\n<li><b><tt>xcount</tt></b>: If you are in a looping template, the total length\nof the array you are looping.</li>\n</ul>\nThis example demonstrates basic row striping using an inline code block and the\n<tt>xindex</tt> variable:</p>\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Company: {[values.company.toUpperCase() + \", \" + values.title]}</p>',\n '<p>Kids: ',\n '<tpl for=\"kids\">',\n '<div class=\"{[xindex % 2 === 0 ? \"even\" : \"odd\"]}\">',\n '{name}',\n '</div>',\n '</tpl></p>'\n );\ntpl.overwrite(panel.body, data);\n </code></pre>\n</div>\n</li>\n\n<li><b><u>Template member functions</u></b>\n<div class=\"sub-desc\">\n<p>One or more member functions can be specified in a configuration\nobject passed into the XTemplate constructor for more complex processing:</p>\n<pre><code>var tpl = new Ext.XTemplate(\n '<p>Name: {name}</p>',\n '<p>Kids: ',\n '<tpl for=\"kids\">',\n '<tpl if=\"this.isGirl(name)\">',\n '<p>Girl: {name} - {age}</p>',\n '</tpl>',\n // use opposite if statement to simulate 'else' processing:\n '<tpl if=\"this.isGirl(name) == false\">',\n '<p>Boy: {name} - {age}</p>',\n '</tpl>',\n '<tpl if=\"this.isBaby(age)\">',\n '<p>{name} is a baby!</p>',\n '</tpl>',\n '</tpl></p>',\n {\n // XTemplate configuration:\n compiled: true,\n // member functions:\n isGirl: function(name){\n return name == 'Sara Grace';\n },\n isBaby: function(age){\n return age < 1;\n }\n }\n);\ntpl.overwrite(panel.body, data);\n </code></pre>\n</div>\n</li>\n\n</ul></div>\n\n",
5 "extends": "Ext.Template",
9 "alternateClassNames": [
21 "member": "Ext.XTemplate",
23 "doc": "<p>The regular expression used to match code variables (default: matches <tt>{[expression]}</tt>).</p>\n",
25 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
27 "html_filename": "XTemplate.html",
28 "href": "XTemplate.html#Ext-XTemplate-cfg-codeRe"
32 "name": "disableFormats",
33 "member": "Ext.Template",
35 "doc": "<p>true to disable format functions in the template. If the template doesn't contain format functions, setting\ndisableFormats to true will reduce apply time (defaults to false)</p>\n",
37 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
39 "html_filename": "Template2.html",
40 "href": "Template2.html#Ext-Template-cfg-disableFormats",
41 "shortDoc": "true to disable format functions in the template. If the template doesn't contain format functions, setting\ndisableFo..."
48 "member": "Ext.Template",
49 "doc": "<p>Applies the supplied <code>values</code> to the template and appends\nthe new node(s) to the specified <code>el</code>.</p>\n\n<p>For example usage <a href=\"#/api/Ext.XTemplate--Template\" rel=\"Ext.XTemplate--Template\" class=\"docClass\">see the constructor</a>.</p>\n\n",
54 "doc": "<p>The context element</p>\n",
58 "type": "Object/Array",
60 "doc": "<p>The template values. Can be an array if the params are numeric (i.e. <code>{0}</code>)\nor an object (i.e. <code>{foo: 'bar'}</code>).</p>\n",
65 "name": "returnElement",
66 "doc": "<p>(optional) true to return an <a href=\"#/api/Ext.core.Element\" rel=\"Ext.core.Element\" class=\"docClass\">Ext.core.Element</a> (defaults to undefined)</p>\n",
71 "type": "HTMLElement/Ext.core.Element",
72 "doc": "<p>The new node or Element</p>\n"
76 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
78 "html_filename": "Template2.html",
79 "href": "Template2.html#Ext-Template-method-append",
80 "shortDoc": "Applies the supplied values to the template and appends\nthe new node(s) to the specified el.\n\nFor example usage see t..."
85 "member": "Ext.XTemplate",
86 "doc": "<p>Alias for <a href=\"#/api/Ext.XTemplate-method-applyTemplate\" rel=\"Ext.XTemplate-method-applyTemplate\" class=\"docClass\">applyTemplate</a>\nReturns an HTML fragment of this template with the specified values applied.</p>\n",
89 "type": "Object/Array",
91 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
97 "doc": "<p>The HTML fragment</p>\n"
101 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
103 "html_filename": "XTemplate.html",
104 "href": "XTemplate.html#Ext-XTemplate-method-apply",
105 "shortDoc": "<p>Alias for <a href=\"#/api/Ext.XTemplate-method-applyTemplate\" rel=\"Ext.XTemplate-method-applyTemplate\" class=\"docClass\">applyTemplate</a>\nReturns an HTML fragment of this template with the specified values applied.</p>\n"
109 "name": "applyTemplate",
110 "member": "Ext.XTemplate",
111 "doc": "<p>Returns an HTML fragment of this template with the specified values applied.</p>\n",
116 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
122 "doc": "<p>The HTML fragment</p>\n"
126 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
128 "html_filename": "XTemplate.html",
129 "href": "XTemplate.html#Ext-XTemplate-method-applyTemplate",
130 "shortDoc": "<p>Returns an HTML fragment of this template with the specified values applied.</p>\n"
135 "member": "Ext.XTemplate",
136 "doc": "<p>Compile the template to a function for optimized performance. Recommended if the template will be used frequently.</p>\n",
142 "doc": "<p>The compiled function</p>\n"
146 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
148 "html_filename": "XTemplate.html",
149 "href": "XTemplate.html#Ext-XTemplate-method-compile",
150 "shortDoc": "<p>Compile the template to a function for optimized performance. Recommended if the template will be used frequently.</p>\n"
155 "member": "Ext.XTemplate",
156 "doc": "<p>Creates a template from the passed element's value (<i>display:none</i> textarea, preferred) or innerHTML.</p>\n",
159 "type": "String/HTMLElement",
161 "doc": "<p>A DOM element or its id</p>\n",
172 "type": "Ext.Template",
173 "doc": "<p>The created template</p>\n"
177 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
179 "html_filename": "XTemplate.html",
180 "href": "XTemplate.html#Ext-XTemplate-method-from",
181 "shortDoc": "<p>Creates a template from the passed element's value (<i>display:none</i> textarea, preferred) or innerHTML.</p>\n"
185 "name": "insertAfter",
186 "member": "Ext.Template",
187 "doc": "<p>Applies the supplied values to the template and inserts the new node(s) after el.</p>\n",
192 "doc": "<p>The context element</p>\n",
196 "type": "Object/Array",
198 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
203 "name": "returnElement",
204 "doc": "<p>(optional) true to return a <a href=\"#/api/Ext.core.Element\" rel=\"Ext.core.Element\" class=\"docClass\">Ext.core.Element</a> (defaults to undefined)</p>\n",
209 "type": "HTMLElement/Ext.core.Element",
210 "doc": "<p>The new node or Element</p>\n"
214 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
216 "html_filename": "Template2.html",
217 "href": "Template2.html#Ext-Template-method-insertAfter",
218 "shortDoc": "<p>Applies the supplied values to the template and inserts the new node(s) after el.</p>\n"
222 "name": "insertBefore",
223 "member": "Ext.Template",
224 "doc": "<p>Applies the supplied values to the template and inserts the new node(s) before el.</p>\n",
229 "doc": "<p>The context element</p>\n",
233 "type": "Object/Array",
235 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
240 "name": "returnElement",
241 "doc": "<p>(optional) true to return a <a href=\"#/api/Ext.core.Element\" rel=\"Ext.core.Element\" class=\"docClass\">Ext.core.Element</a> (defaults to undefined)</p>\n",
246 "type": "HTMLElement/Ext.core.Element",
247 "doc": "<p>The new node or Element</p>\n"
251 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
253 "html_filename": "Template2.html",
254 "href": "Template2.html#Ext-Template-method-insertBefore",
255 "shortDoc": "<p>Applies the supplied values to the template and inserts the new node(s) before el.</p>\n"
259 "name": "insertFirst",
260 "member": "Ext.Template",
261 "doc": "<p>Applies the supplied values to the template and inserts the new node(s) as the first child of el.</p>\n",
266 "doc": "<p>The context element</p>\n",
270 "type": "Object/Array",
272 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
277 "name": "returnElement",
278 "doc": "<p>(optional) true to return a <a href=\"#/api/Ext.core.Element\" rel=\"Ext.core.Element\" class=\"docClass\">Ext.core.Element</a> (defaults to undefined)</p>\n",
283 "type": "HTMLElement/Ext.core.Element",
284 "doc": "<p>The new node or Element</p>\n"
288 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
290 "html_filename": "Template2.html",
291 "href": "Template2.html#Ext-Template-method-insertFirst",
292 "shortDoc": "<p>Applies the supplied values to the template and inserts the new node(s) as the first child of el.</p>\n"
297 "member": "Ext.Template",
298 "doc": "<p>Applies the supplied values to the template and overwrites the content of el with the new node(s).</p>\n",
303 "doc": "<p>The context element</p>\n",
307 "type": "Object/Array",
309 "doc": "<p>The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})</p>\n",
314 "name": "returnElement",
315 "doc": "<p>(optional) true to return a <a href=\"#/api/Ext.core.Element\" rel=\"Ext.core.Element\" class=\"docClass\">Ext.core.Element</a> (defaults to undefined)</p>\n",
320 "type": "HTMLElement/Ext.core.Element",
321 "doc": "<p>The new node or Element</p>\n"
325 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
327 "html_filename": "Template2.html",
328 "href": "Template2.html#Ext-Template-method-overwrite",
329 "shortDoc": "<p>Applies the supplied values to the template and overwrites the content of el with the new node(s).</p>\n"
334 "member": "Ext.Template",
335 "doc": "<p>Sets the HTML used as the template and optionally compiles it.</p>\n",
346 "doc": "<p>(optional) True to compile the template (defaults to undefined)</p>\n",
351 "type": "Ext.Template",
352 "doc": "<p>this</p>\n"
356 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/Template.js",
358 "html_filename": "Template2.html",
359 "href": "Template2.html#Ext-Template-method-set",
360 "shortDoc": "<p>Sets the HTML used as the template and optionally compiles it.</p>\n"
369 "filename": "/Users/nick/Projects/sencha/SDK/platform/src/XTemplate.js",
371 "html_filename": "XTemplate.html",
372 "href": "XTemplate.html#Ext-XTemplate",