helma.org/wiki/JavaScript Template Engine

Version 54

Lehni — Sun, 22 Apr 2007 07:23:44 +0000

163	0.24 Added browser support. Tested on Safari and Firefox.
164	Fixed a bug in conditional statements containing '=='.
165
183
185
189
193
194	0.15 Added the possibility for macro tags to suppress swallow the following line
195	Control tags like if, else, elseif, end, foreach, set and comments
196	(<%-- --%>) automatically suppress swallow the following line seperator.
201
204
206
207	0.11 Replaced all the dirty hacks for keeping track of template line numbers
211
214
217
223
229
232

Version 53

Lehni — Mon, 16 Apr 2007 18:35:10 +0000

101	<% foreach $item in param.list %>
102	<%= $item#index %>
103	<%= $item#length %>
104	<%= $item#isFirst %>
105	<%= $item#isLast %>
106	<% end %>
149	<% do_something macro_call default=$text %>

Version 52

Lehni — Mon, 16 Apr 2007 18:32:27 +0000

38	* Loop variables give access to the state of the loop: $variable#isFirst, #isLast, #index, #length.
92	During every for loop these helper variables are available:
93
94	$variable#index // Index of the current iteration
95	$variable#length // Length of the entire for loop
96	$variable#isFirst // Is this the first iteration?
97	$variable#isLast // Is this the last iternation?
98
99	E.g.:
100
101	<% foreach $item in param.list %>
102	<%= $item#index %>
103	<%= $item#length %>
104	<%= $item#isFirst %>
105	<%= $item#isLast %>
106	<% end %>
107
128	=====Sub Templates Variables
129
140	A tag ending with -%> is trimmed after rendering, so that an empty template really
141	results in an empty string:
142
143	<% $empty -%>
144
143	0.23 Added loop variables: $variable#index, #length, #isFirst, #isLast.
144	Many bug fixes.
145

Version 51

Lehni — Sat, 14 Apr 2007 21:09:19 +0000

91	=====Swallow CR LF after tagsLine Breaks
134
144
149
152
155
157
161
165
170
175
178
180
186
189
192
198
204
207

Version 50

Lehni — Sat, 14 Apr 2007 21:06:29 +0000

41	=====Conditional statements, expressions:
59	=====Loops:Loops
91	=====Swallow CR LF after tags:tags
102	=====Sub Templates:Templates
137	====Revisions:Revisions
144
149
152
155
157
161
165
170
175
178
180
186
189
192
198
204
207

Version 49

Lehni — Sat, 14 Apr 2007 21:05:02 +0000

41	=====Conditional statements, expressions:
59	=====Loops:
91	=====Swallow CR LF after tags:
102	=====Sub Templates:

Version 48

Lehni — Sat, 14 Apr 2007 21:04:23 +0000

13	The file needs to be placed in the global protoype, it adds one function to the HopObject prototype:====Helma Integration
15	<tt>HopObjectTemplate.renderTemplate(name, param, out)</tt>js needs to be placed in the global protoype.
16	It adds the function renderTemplate() to the HopObject prototype, that can be then called on any HopObject.
17	* name is the name of the skin<tt>HopObject.prototype.renderTemplate(name, without the extension. "jstl" is used as extension for the template filesparam, which stands for "JavaScript Template Language".out)</tt>
18	* param is the optional parameter, which can be accessed from the templates, just like in Helma skins.
19	* out is the writer object where the whole template is written to. if none is specified, renderTemplate renders into a StringBuffer and returns its value as a string.
19	* <tt>name</tt> is the name of the skin, without the extension. "jstl" is used as extension for the template files, which stands for "JavaScript Template Language".
20	* <tt>param</tt> is the optional parameter, which can be accessed from the templates, just like in Helma skins.
21	* <tt>out</tt> is the writer object where the whole template is written to. if none is specified, renderTemplate renders into a StringBuffer and returns its value as a string.
22
51	Result:
52
53	Hello World
54
80	Results in: [1, 2, 3]Result:
82	==== [1, 2, 3]
91	Resulting in:Result:

Version 47

Lehni — Sat, 14 Apr 2007 21:00:43 +0000

13	Revisions:
14
15	0.22 More clean-ups in macro parsing code, distinction between control tags
16	and macro tags is now only on the handling level, not parsing level.
17	This adds feature like prefix / suffix to foreach and if / elseif, and
18	resulted in cleaner code.
19	Additionally, the separator parameter can now be set in foreach.
20
21	0.21 Major rewrite and refactoring of most parts, adaption of Hannes' latest
22	additions to Helma skins (sub templates, nested macros, filters),
23	varios design changes (e.g. only allow to define and set $-variables for
24	inside templates).
25
26	0.20 Refactored the code rendering code to be more readibly and smaller.
27	Removed Helma dependency, by using preprocessing macros.
28
29	0.19 Added support for sub templates and a special macro
30	for both rendering sub templates and external templates.
31
32	0.18 Added support for encoding parameter, fixed a bug in <% else %>
33
34	0.17 Many clean-ups and simplifications of regular expressions and parsing.
35	At parsing time, no code is evaluated any longer, except the final
36	result. This leads to further speed improvements by about 1.5.
37
38	0.16 Fixed issues with the display of errors. The correct line numbers
39	should be reported now. If a macro call results in an exception
40	The exception is caught and repported just like in Helma skins now.
41
42	0.15 Added the possibility for macro tags to suppress the following line
43	separator, if there is any, by adding a minus at the end: <% macro -%>.
44	Control tags like if, else, elseif, end, foreach, set and comments
45	(<%-- --%>) automatically suppress the following line seperator.
46
47	0.14 Added support for res.handlers.
48	Switched to java.util.regex for the tag parser.
49	Fixed a bug with escaped quotes in macro parameters.
50	Reformated template generating code to be more readable.
51
52	0.13 Added support for properties in <% %>-tags (not only macros)
53	and fixed an incompatibility with the Rhino Debugger and jstl templates.
54
55	0.12 Fixed various bugs that were introduced in the 0.11 rewrite.
56
57	0.11 Replaced all the dirty hacks for keeping track of template line numbers
58	and linking them to code line numbers by a clean implementation of the
59	same functionality.
60	The result is a faster and less resource hungry parser.
61	Cleaned up the code, seperated tag parser form line parser.
62
63	0.10 More speed improvements, parsing is now around 6-7 times faster
64	than in 0.8
65
66	0.9 Various speed improvements, leading to an overall decrease of parsing
67	time by more than factor 3.
68
69	0.8 Added support for HopObject collections in foreach
70	Removed regexp filter for if() expressions that sometimes seemed
71	to deadlock
72	Fixed a bug with finding the right template in the inheritance chain
73	if it was overriden by another one.
74
75	0.7 Fixed problems with error reports. Full stacktraces are now printed,
76	and errors caused in macros called from the template are now properly
77	detected and reported.
78	Switched to using Context.evaluateString() instead of eval(),
79	for improve of speed and reception of proper exceptions.
80
81	0.6 fixed a bug that caused macros in objects other than 'this' and
82	'root' to fail.
83
84	0.5 first public release.
85
31	====Features
32
33	* Macros with conditional statements and loops can define prefix, suffix default and encoding parameters too.
34	* Loops can define an additional paraemter called separator, which will be added between entries, but only if there was output.
35	* Any macro that ends with -%> swallows the following line break.
36
42	Conditional statements support prefix, suffix and default:
43
44	<% if param.greetings prefix="Hello" %>
45	World
46	<% end %>
47
65	Loops support prefix, suffix, default and separator:
66
67	<% foreach $value in [1, 2, 3] prefix="[ " suffix=" ]" separator=", " %>
68	<%= $value %>
69	<% end %>
70
71	Results in: [1, 2, 3]
72
73	====
74
111
112	====Revisions:
113
114	0.22 More clean-ups in macro parsing code, distinction between control tags
115	and macro tags is now only on the handling level, not parsing level.
116	This adds feature like prefix / suffix to foreach and if / elseif, and
117	resulted in cleaner code.
118	Additionally, the separator parameter can now be set in foreach.
119
120	0.21 Major rewrite and refactoring of most parts, adaption of Hannes' latest
121	additions to Helma skins (sub templates, nested macros, filters),
122	varios design changes (e.g. only allow to define and set $-variables for
123	inside templates).
124
125	0.20 Refactored the code rendering code to be more readibly and smaller.
126	Removed Helma dependency, by using preprocessing macros.
127
128	0.19 Added support for sub templates and a special macro
129	for both rendering sub templates and external templates.
130
131	0.18 Added support for encoding parameter, fixed a bug in <% else %>
132
133	0.17 Many clean-ups and simplifications of regular expressions and parsing.
134	At parsing time, no code is evaluated any longer, except the final
135	result. This leads to further speed improvements by about 1.5.
136
137	0.16 Fixed issues with the display of errors. The correct line numbers
138	should be reported now. If a macro call results in an exception
139	The exception is caught and repported just like in Helma skins now.
140
141	0.15 Added the possibility for macro tags to suppress the following line
142	separator, if there is any, by adding a minus at the end: <% macro -%>.
143	Control tags like if, else, elseif, end, foreach, set and comments
144	(<%-- --%>) automatically suppress the following line seperator.
145
146	0.14 Added support for res.handlers.
147	Switched to java.util.regex for the tag parser.
148	Fixed a bug with escaped quotes in macro parameters.
149	Reformated template generating code to be more readable.
150
151	0.13 Added support for properties in <% %>-tags (not only macros)
152	and fixed an incompatibility with the Rhino Debugger and jstl templates.
153
154	0.12 Fixed various bugs that were introduced in the 0.11 rewrite.
155
156	0.11 Replaced all the dirty hacks for keeping track of template line numbers
157	and linking them to code line numbers by a clean implementation of the
158	same functionality.
159	The result is a faster and less resource hungry parser.
160	Cleaned up the code, seperated tag parser form line parser.
161
162	0.10 More speed improvements, parsing is now around 6-7 times faster
163	than in 0.8
164
165	0.9 Various speed improvements, leading to an overall decrease of parsing
166	time by more than factor 3.
167
168	0.8 Added support for HopObject collections in foreach
169	Removed regexp filter for if() expressions that sometimes seemed
170	to deadlock
171	Fixed a bug with finding the right template in the inheritance chain
172	if it was overriden by another one.
173
174	0.7 Fixed problems with error reports. Full stacktraces are now printed,
175	and errors caused in macros called from the template are now properly
176	detected and reported.
177	Switched to using Context.evaluateString() instead of eval(),
178	for improve of speed and reception of proper exceptions.
179
180	0.6 fixed a bug that caused macros in objects other than 'this' and
181	'root' to fail.
182
183	0.5 first public release.
184

Version 46

Lehni — Sat, 14 Apr 2007 20:49:43 +0000

101	* <tt><%= param.object.href() %></tt>: prints out the value or the result of a function call. response, request, session do NOT yet link to res.data, req.data, session.data.
107	<% if (sessionsession.user != null) null %>

Version 45

Lehni — Sat, 14 Apr 2007 20:48:19 +0000

15	0.22 More clean-ups in macro parsing code, distinction between control tags
16	and macro tags is now only on the handling level, not parsing level.
17	This adds feature like prefix / suffix to foreach and if / elseif, and
18	resulted in cleaner code.
19	Additionally, the separator parameter can now be set in foreach.
20
91	* <tt><% foreach ($object $object in list) list %> ... <% end %></tt>: loops over the list, on purpose not named "for ($object in list)", because object won't be the index but the object itself
92	* <tt><% if () ... %>, <% elseif () ... %>, <% else %>, <% end %></tt>
110	<% foreach ($topic $topic in param.topics) topic %>
116	<% if ($count $count == 1) 1 %>
118	<% elseif ($count $count > 1) 1 %>

Version 44

Lehni — Fri, 13 Apr 2007 18:51:29 +0000

94	* <tt><% macro >nested content</%></tt>: passes the nested content to the macro, as a second parameter.
143	The implementation of sub templates has changed a lot to reflect the new skin features outlined here. Sub template are to be added at the end of files:
144	Sub template are to be added at the end of files:

Version 43

Lehni — Fri, 13 Apr 2007 18:50:21 +0000

132	Any tag can end with -%> to indicated that it does not want the new line afterafter it beig being rendered. By default. All the control macros do so by default:
133	it beig being rendered. By default. All the control macros do so by default:
143	The implementation of sub templates has change changed a lot to reflect the new skinskin features outlined here. Sub template are to be added at the end of files:
144	features outlined here. Sub template are to be added at the end of files:
169	These can then be used like normal variables, and for example be passed asas the default value in another macro. Note that althought the definition is at the end, the variable is valid in the whole scope.
170	the default value in another macro. Note that althought the definition is at the end, the variable is valid in the whole scope.

Version 42

Lehni — Fri, 13 Apr 2007 18:49:33 +0000

171	This These can then be used like a normal variablevariables, and for example be passed as
172	the default value in another macro:macro. Note that althought the definition is at the end, the variable is valid in the whole scope.

Version 41

Lehni — Fri, 13 Apr 2007 18:14:01 +0000

Due to all these changes, I have decided to keep the last revision before the changes here (Template-20.js). Also, I uploaded the unprocessed file for those interested in seeing how I am using the cpp preprocessor from gcc among with stripjsjsstrip.py and sed to produce the final files. I will write more about this soon.

Version 40

Lehni — Fri, 13 Apr 2007 18:13:25 +0000

9	Due to all these changes, I have decided to keep the last revision before the changes here (Template-20.js). Also, I uploaded the unprocessed file for those interested in seeing how I am using the cpp preprocessor from gcc among with stripjs.py and sed to produce the final files. I will write more about this soon.
10

Version 39

Lehni — Fri, 13 Apr 2007 18:07:51 +0000

12
17
20
23
25
29
33
36	Control tags like if, else, elseif, end, foreach, set and comments comments
38
43
46
48
49	0.11 Replaced all the dirty hacks for keeping track of template line numbers numbers
53
56
59
65
71
74
119

Version 38

Lehni — Fri, 13 Apr 2007 18:07:11 +0000

12
17
20
23
25
29
33
36	Control tags like if, else, elseif, end, foreach, set and comments comments
38
43
46
48
49	0.11 Replaced all the dirty hacks for keeping track of template line numbers numbers
53
56
59
65
71
74
119

Version 37

Lehni — Fri, 13 Apr 2007 18:04:50 +0000

17
20
38
91	* <tt><% macro foo="bar" array=[1,2,3] hash={a:1, b: 2, c:3} nested=<% <% param.value %> %> \| filter param="string" %></tt>: calls the macro. Supported are: Global macros, object macros and res.handlers (e.g. this.macro, root.macro, etc.); prefix, suffix, default, encoding parameters; Neted macros; Filter chains. This is supposed to be fully backward compatible with Helma 1 skins.
127
128	====Swallow CR LF after tags:
129
130	Any tag can end with -%> to indicated that it does not want the new line after
131	it beig being rendered. By default. All the control macros do so by default:
132
133	<%= "Hel" -%>
134	<%= "ma" %>
135
136	Resulting in:
137
138	Helma

Version 36

Lehni — Fri, 13 Apr 2007 18:00:41 +0000

7	With revision 0.21 came many changes that reflect the recent addition of new skin features in Helma 1.6\|http://dev.helma.org/wiki/New+Skin+Features+in+Helma+1.6/.
8
12	0.21 Major rewrite and refactoring of most parts, adaption of Hannes' latest
13	additions to Helma skins (sub templates, nested macros, filters),
14	varios design changes (e.g. only allow to define and set $-variables for
15	inside templates).
16
17	0.20 Refactored the code rendering code to be more readibly and smaller.
18	Removed Helma dependency, by using preprocessing macros.
19
30
43	same functionality. The result is a faster and less resource hungry parser.
44	The result is a faster and less resource hungry parser.
46	0.10 More speed improvements, parsing is now around 6-7 times faster than in 0.faster
47	than in 0.8
48	0.9 Various speed improvements, leading to an overall decrease of parsing timeparsing
49	time by more than factor 3.
51	Removed regexp filter for if() expressions that sometimes seemed to deadlockseemed
52	Fixed a bug with finding the right template in the inheritance chain if itto deadlock
53	was overriden by another one.Fixed a bug with finding the right template in the inheritance chain
54	if it was overriden by another one.
53	0.7 Fixed problems with error reports. Full stacktraces are now printed, and errors
54	and errors caused in macros called from the template are now properly detected and reported.properly
55	Switched to using Contextdetected and reported.evaluateString() instead of eval(), for improve of speed
56	and reception of proper exceptionsSwitched to using Context.evaluateString() instead of eval(),
57	for improve of speed and reception of proper exceptions.
55	0.6 fixed a bug that caused macros in objects other than 'this' and 'root' to fail.and
56	'root' to fail.
69	* <tt><% foreach (object ($object in list) %> ... <% end %></tt>: loops over the list, on purpose not named "for (object ($object in list)", because object won't be the index but the object itself
71	* <tt><% set variable $variable = otherVariable [ + some arithmetic ] %>,</tt> e.g. <tt><% set count $count = this.nodes.count() %></tt>
72	* <tt><% macro foo="bar" array=[1,2,3] hash={a:1, b: 2, c:3} nested=<% param.value %> \| filter param="string" %></tt>: calls the macro. Supported are: Global macros, both global macros and object based macros are supported and res.handlers (e.g. this.macro, root.macro, etc.). ); prefix, suffix, default are supporteddefault, encoding parameters; Neted macros; Filter chains. It This is supposed to be fully backward compatible with Helma 1 skins.
73	* <tt><% param.value %></tt>: prints out the value, response, request, sesion, param are suppored, as links to res.data, req.data, session.data, param. Filters, parameters and nested macros work just as in macro calls. This is here mostly for backward compatibility. The prefered and faster way of printing simple data is:
74	* <tt><%= param.object.href() %></tt>: prints out the value or the result of a function call. response, request, session do NOT yet link to res.data, req.data, session.data.
88	<% foreach (topic ($topic in param.topics) %>
90	<td><%= topic$topic.renderLink() %></td>
91	<td><%= topic$topic.creator.renderLink() %></td>
92	<% set count $count = topic.comments.count() - 1 %>
93	<% if (count ($count == 1) %>
94	<% elseif (count ($count > 1) %>
95	<%= count $count %> Posts
99	<td nowrap><%= topic$topic.createDate.format(createDate \| format "dd.MM.yy - HH:mm") %></td>
106	The implementation of sub templates has change a lot to reflect the new skin
107	features outlined here. Sub template are to be added at the end of files:
108	http://dev.helma.org/wiki/New+Skin+Features+in+Helma+1.6/
109
109	<% template "name"#name %>
111	</%>Empty lines before and after it are automatically removed.
113	<% #greedy +%>
114	This is another sub-template. As apposed to the other one, this one keeps the
115	empty lines due to the +.
116
116	<% render this.template "name#name" value="variables" %>
120	<% this.render template "name" foo="bar" %>
122	Definition of a template and rendering into a scope variable in one command:
124	<% set "text"$text %>
125	Render this text into 'text$text'. Again, <% macros %> can be called.
126	</%>
126	This can now then be used like a normal variable, and for example be passed as
129	<%= text $text %>
131	<% do_something default=text $text %>

Version 35

zumbrunn — Fri, 02 Mar 2007 03:13:30 +0000

7	Download\|http://dev<% this.helma.org/static/helma.dev/wiki/JavaScript%20Template%20Engine/Template.jsattachments %>

Version 34

zumbrunn — Thu, 15 Feb 2007 09:23:08 +0000

7	Download\|http://dev.helma.org/static/helma.dev/Wiki/JavaScript%20Template%20Engine/Templatedev/wiki/JavaScript%20Template%20Engine/Template.js