Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
6 | Andrea | 1 | <?xml version="1.0" encoding="UTF-8"?> |
2 | <!-- |
||
3 | /* |
||
4 | * $Id: tiles-jsp.tld 606013 2007-12-20 20:02:36Z apetrelli $ |
||
5 | * |
||
6 | * Licensed to the Apache Software Foundation (ASF) under one |
||
7 | * or more contributor license agreements. See the NOTICE file |
||
8 | * distributed with this work for additional information |
||
9 | * regarding copyright ownership. The ASF licenses this file |
||
10 | * to you under the Apache License, Version 2.0 (the |
||
11 | * "License"); you may not use this file except in compliance |
||
12 | * with the License. You may obtain a copy of the License at |
||
13 | * |
||
14 | * http://www.apache.org/licenses/LICENSE-2.0 |
||
15 | * |
||
16 | * Unless required by applicable law or agreed to in writing, |
||
17 | * software distributed under the License is distributed on an |
||
18 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
||
19 | * KIND, either express or implied. See the License for the |
||
20 | * specific language governing permissions and limitations |
||
21 | * under the License. |
||
22 | */ |
||
23 | --> |
||
24 | <!DOCTYPE taglib PUBLIC |
||
25 | "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" |
||
26 | "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> |
||
27 | <taglib> |
||
28 | <tlib-version>2.0</tlib-version> |
||
29 | <jsp-version>1.2</jsp-version> |
||
30 | <short-name>tiles</short-name> |
||
31 | <uri>http://tiles.apache.org/tags-tiles</uri> |
||
32 | <description> |
||
33 | <![CDATA[ |
||
34 | <p>This tag library provides Tiles tags.</p> |
||
35 | ]]> |
||
36 | </description> |
||
37 | <tag> |
||
38 | <name>insertTemplate</name> |
||
39 | <tag-class>org.apache.tiles.jsp.taglib.InsertTemplateTag</tag-class> |
||
40 | <body-content>JSP</body-content> |
||
41 | <description> |
||
42 | <![CDATA[ |
||
43 | <p><strong>Insert a template.</strong></p> |
||
44 | <p>Insert a template with the possibility to pass |
||
45 | parameters (called attributes). |
||
46 | A template can be seen as a procedure that can take parameters or attributes. |
||
47 | <code><tiles:insertTemplate></code> allows to define these attributes |
||
48 | and pass them to the inserted jsp page, called template. |
||
49 | Attributes are defined using nested tag |
||
50 | <code><tiles:putAttribute></code> or |
||
51 | <code><tiles:putListAttribute></code>. |
||
52 | </p> |
||
53 | <p>You must specify <li><code>template</code> attribute, for inserting a template</p> |
||
54 | |||
55 | <p><strong>Example : </strong></p> |
||
56 | <pre> |
||
57 | <code> |
||
58 | <tiles:insertTemplate template="/basic/myLayout.jsp" flush="true"> |
||
59 | <tiles:putAttribute name="title" value="My first page" /> |
||
60 | <tiles:putAttribute name="header" value="/common/header.jsp" /> |
||
61 | <tiles:putAttribute name="footer" value="/common/footer.jsp" /> |
||
62 | <tiles:putAttribute name="menu" value="/basic/menu.jsp" /> |
||
63 | <tiles:putAttribute name="body" value="/basic/helloBody.jsp" /> |
||
64 | </tiles:insert> |
||
65 | </code> |
||
66 | </pre> |
||
67 | ]]> |
||
68 | </description> |
||
69 | <attribute> |
||
70 | <name>template</name> |
||
71 | <required>true</required> |
||
72 | <rtexprvalue>true</rtexprvalue> |
||
73 | <description> |
||
74 | <![CDATA[ |
||
75 | <p>A string representing the URI of a template (for example, a JSP |
||
76 | page). |
||
77 | </p> |
||
78 | ]]> |
||
79 | </description> |
||
80 | </attribute> |
||
81 | <attribute> |
||
82 | <name>flush</name> |
||
83 | <required>false</required> |
||
84 | <rtexprvalue>false</rtexprvalue> |
||
85 | <type>boolean</type> |
||
86 | <description> |
||
87 | <![CDATA[ |
||
88 | <p>True or false. If true, current page out stream is flushed |
||
89 | before insertion.</p> |
||
90 | ]]> |
||
91 | </description> |
||
92 | </attribute> |
||
93 | <attribute> |
||
94 | <name>ignore</name> |
||
95 | <required>false</required> |
||
96 | <rtexprvalue>true</rtexprvalue> |
||
97 | <type>boolean</type> |
||
98 | <description> |
||
99 | <![CDATA[ |
||
100 | <p>If this attribute is set to true, and the attribute specified by the |
||
101 | name does not exist, simply return without writing anything. The |
||
102 | default value is false, which will cause a runtime exception to be |
||
103 | thrown.</p> |
||
104 | ]]> |
||
105 | </description> |
||
106 | </attribute> |
||
107 | <attribute> |
||
108 | <name>role</name> |
||
109 | <required>false</required> |
||
110 | <rtexprvalue>true</rtexprvalue> |
||
111 | <description> |
||
112 | <![CDATA[ |
||
113 | <p>If the user is in the specified role, the tag is taken into account; |
||
114 | otherwise, the tag is ignored (skipped).</p> |
||
115 | ]]> |
||
116 | </description> |
||
117 | </attribute> |
||
118 | |||
119 | <attribute> |
||
120 | <name>preparer</name> |
||
121 | <required>false</required> |
||
122 | <rtexprvalue>true</rtexprvalue> |
||
123 | <description> |
||
124 | The fully qualified class name of the preparer. |
||
125 | </description> |
||
126 | </attribute> |
||
127 | </tag> |
||
128 | <tag> |
||
129 | <name>insertDefinition</name> |
||
130 | <tag-class>org.apache.tiles.jsp.taglib.InsertDefinitionTag</tag-class> |
||
131 | <body-content>JSP</body-content> |
||
132 | <description> |
||
133 | <![CDATA[ |
||
134 | <p><strong>Insert a definition.</strong></p> |
||
135 | <p>Insert a definition with the possibility to override and specify |
||
136 | parameters (called attributes). |
||
137 | A definition can be seen as a (partially or totally) filled template that |
||
138 | can override or complete attribute values. |
||
139 | <code><tiles:insertDefinition></code> allows to define these attributes |
||
140 | and pass them to the inserted jsp page, called template. |
||
141 | Attributes are defined using nested tag <code><tiles:putAttribute></code> or |
||
142 | <code><tiles:putListAttribute></code>. |
||
143 | </p> |
||
144 | <p>You must specify <code>name</code> tag attribute, for inserting a definition from |
||
145 | definitions factory.</p> |
||
146 | <p><strong>Example : </strong></p> |
||
147 | <pre> |
||
148 | <code> |
||
149 | <tiles:insertDefinition name=".my.tiles.defininition flush="true"> |
||
150 | <tiles:putAttribute name="title" value="My first page" /> |
||
151 | <tiles:putAttribute name="header" value="/common/header.jsp" /> |
||
152 | <tiles:putAttribute name="footer" value="/common/footer.jsp" /> |
||
153 | <tiles:putAttribute name="menu" value="/basic/menu.jsp" /> |
||
154 | <tiles:putAttribute name="body" value="/basic/helloBody.jsp" /> |
||
155 | </tiles:insertDefinition> |
||
156 | </code> |
||
157 | </pre> |
||
158 | ]]> |
||
159 | </description> |
||
160 | <attribute> |
||
161 | <name>name</name> |
||
162 | <required>true</required> |
||
163 | <rtexprvalue>true</rtexprvalue> |
||
164 | <description> |
||
165 | <![CDATA[ |
||
166 | <p>Name of the definition to insert.</p> |
||
167 | ]]> |
||
168 | </description> |
||
169 | </attribute> |
||
170 | <attribute> |
||
171 | <name>flush</name> |
||
172 | <required>false</required> |
||
173 | <rtexprvalue>false</rtexprvalue> |
||
174 | <type>boolean</type> |
||
175 | <description> |
||
176 | <![CDATA[ |
||
177 | <p>True or false. If true, current page out stream is flushed |
||
178 | before insertion.</p> |
||
179 | ]]> |
||
180 | </description> |
||
181 | </attribute> |
||
182 | <attribute> |
||
183 | <name>ignore</name> |
||
184 | <required>false</required> |
||
185 | <rtexprvalue>true</rtexprvalue> |
||
186 | <type>boolean</type> |
||
187 | <description> |
||
188 | <![CDATA[ |
||
189 | <p>If this attribute is set to true, and the attribute specified by the |
||
190 | name does not exist, simply return without writing anything. The |
||
191 | default value is false, which will cause a runtime exception to be |
||
192 | thrown.</p> |
||
193 | ]]> |
||
194 | </description> |
||
195 | </attribute> |
||
196 | <attribute> |
||
197 | <name>role</name> |
||
198 | <required>false</required> |
||
199 | <rtexprvalue>true</rtexprvalue> |
||
200 | <description> |
||
201 | <![CDATA[ |
||
202 | <p>If the user is in the specified role, the tag is taken into account; |
||
203 | otherwise, the tag is ignored (skipped).</p> |
||
204 | ]]> |
||
205 | </description> |
||
206 | </attribute> |
||
207 | |||
208 | <attribute> |
||
209 | <name>preparer</name> |
||
210 | <required>false</required> |
||
211 | <rtexprvalue>true</rtexprvalue> |
||
212 | <description> |
||
213 | The fully qualified class name of preparer. |
||
214 | </description> |
||
215 | </attribute> |
||
216 | </tag> |
||
217 | <tag> |
||
218 | <name>insertAttribute</name> |
||
219 | <tag-class>org.apache.tiles.jsp.taglib.InsertAttributeTag</tag-class> |
||
220 | <body-content>JSP</body-content> |
||
221 | <description> |
||
222 | <![CDATA[ |
||
223 | <p><strong>Inserts the value of an attribute into the page.</strong></p> |
||
224 | <p>This tag can be flexibly used to insert the value of an attribute into a page. |
||
225 | As in other usages in Tiles, every attribute can be determined to have a "type", |
||
226 | either set explicitly when it was defined, or "computed". If the type is not explicit, then |
||
227 | if the attribute value is a valid definition, it will be inserted as such. Otherwise, |
||
228 | if it begins with a "/" character, it will be treated as a "template". Finally, if it |
||
229 | has not otherwise been assigned a type, it will be treated as a String and included without |
||
230 | any special handling.</p> |
||
231 | |||
232 | <p><strong>Example : </strong></p> |
||
233 | <pre> |
||
234 | <code> |
||
235 | <tiles:insertAttribute name="body" /> |
||
236 | </code> |
||
237 | </pre> |
||
238 | ]]> |
||
239 | </description> |
||
240 | <attribute> |
||
241 | <name>name</name> |
||
242 | <required>false</required> |
||
243 | <rtexprvalue>true</rtexprvalue> |
||
244 | <description> |
||
245 | <![CDATA[ |
||
246 | <p>Name of the attribute to insert. This attribute will be ignored if |
||
247 | the <code>value</code> attribute is specified.</p> |
||
248 | ]]> |
||
249 | </description> |
||
250 | </attribute> |
||
251 | <attribute> |
||
252 | <name>value</name> |
||
253 | <required>false</required> |
||
254 | <rtexprvalue>true</rtexprvalue> |
||
255 | <type>java.lang.Object</type> |
||
256 | <description> |
||
257 | <![CDATA[ |
||
258 | <p>Attribute object to render directly. If it specified, the <code>name</code> |
||
259 | attribute will be ignored.</p> |
||
260 | ]]> |
||
261 | </description> |
||
262 | </attribute> |
||
263 | <attribute> |
||
264 | <name>flush</name> |
||
265 | <required>false</required> |
||
266 | <rtexprvalue>false</rtexprvalue> |
||
267 | <type>boolean</type> |
||
268 | <description> |
||
269 | <![CDATA[ |
||
270 | <p>True or false. If true, current page out stream is flushed |
||
271 | before insertion.</p> |
||
272 | ]]> |
||
273 | </description> |
||
274 | </attribute> |
||
275 | <attribute> |
||
276 | <name>ignore</name> |
||
277 | <required>false</required> |
||
278 | <rtexprvalue>true</rtexprvalue> |
||
279 | <type>boolean</type> |
||
280 | <description> |
||
281 | <![CDATA[ |
||
282 | <p>If this attribute is set to true, and the attribute specified by the |
||
283 | name does not exist, simply return without writing anything. The |
||
284 | default value is false, which will cause a runtime exception to be |
||
285 | thrown.</p> |
||
286 | ]]> |
||
287 | </description> |
||
288 | </attribute> |
||
289 | <attribute> |
||
290 | <name>role</name> |
||
291 | <required>false</required> |
||
292 | <rtexprvalue>true</rtexprvalue> |
||
293 | <description> |
||
294 | <![CDATA[ |
||
295 | <p>If the user is in the specified role, the tag is taken into account; |
||
296 | otherwise, the tag is ignored (skipped).</p> |
||
297 | ]]> |
||
298 | </description> |
||
299 | </attribute> |
||
300 | <attribute> |
||
301 | <name>preparer</name> |
||
302 | <required>false</required> |
||
303 | <rtexprvalue>true</rtexprvalue> |
||
304 | <description> |
||
305 | The fully qualified name of the preparer. |
||
306 | </description> |
||
307 | </attribute> |
||
308 | </tag> |
||
309 | <tag> |
||
310 | <name>definition</name> |
||
311 | <tag-class>org.apache.tiles.jsp.taglib.definition.DefinitionTag</tag-class> |
||
312 | <body-content>JSP</body-content> |
||
313 | <description> |
||
314 | <![CDATA[ |
||
315 | <p><strong>Create a definition at runtime. |
||
316 | </strong></p> |
||
317 | <p>Create a new definition at runtime. |
||
318 | Newly created definition will be available across the entire request. |
||
319 | </p>]]> |
||
320 | </description> |
||
321 | <attribute> |
||
322 | <name>name</name> |
||
323 | <required>true</required> |
||
324 | <rtexprvalue>true</rtexprvalue> |
||
325 | <description> |
||
326 | <![CDATA[ |
||
327 | <p>Specifies the name under which the newly created definition bean |
||
328 | will be saved.</p> |
||
329 | ]]> |
||
330 | </description> |
||
331 | </attribute> |
||
332 | <attribute> |
||
333 | <name>template</name> |
||
334 | <required>false</required> |
||
335 | <rtexprvalue>true</rtexprvalue> |
||
336 | <description> |
||
337 | <![CDATA[ |
||
338 | <p>A string representing the URI of a template |
||
339 | (a JSP page).</p> |
||
340 | ]]> |
||
341 | </description> |
||
342 | </attribute> |
||
343 | <attribute> |
||
344 | <name>role</name> |
||
345 | <required>false</required> |
||
346 | <rtexprvalue>true</rtexprvalue> |
||
347 | <description> |
||
348 | <![CDATA[ |
||
349 | <p>Role to check before inserting this definition. If role is not |
||
350 | defined for current user, definition is not inserted. Checking is |
||
351 | done at insert time, not during definition process.</p> |
||
352 | ]]> |
||
353 | </description> |
||
354 | </attribute> |
||
355 | <attribute> |
||
356 | <name>extends</name> |
||
357 | <required>false</required> |
||
358 | <rtexprvalue>true</rtexprvalue> |
||
359 | <description> |
||
360 | <![CDATA[ |
||
361 | <p>Name of a parent definition that is used to initialize this new |
||
362 | definition. Parent definition is searched in definitions factory.</p> |
||
363 | ]]> |
||
364 | </description> |
||
365 | </attribute> |
||
366 | <attribute> |
||
367 | <name>preparer</name> |
||
368 | <required>false</required> |
||
369 | <rtexprvalue>true</rtexprvalue> |
||
370 | <description> |
||
371 | <![CDATA[ |
||
372 | <p>Specifies the preparer name to use. The specified preparer will |
||
373 | be executed before rendering this newly created definition.</p> |
||
374 | ]]> |
||
375 | </description> |
||
376 | </attribute> |
||
377 | </tag> |
||
378 | <tag> |
||
379 | <name>putAttribute</name> |
||
380 | <tag-class>org.apache.tiles.jsp.taglib.PutAttributeTag</tag-class> |
||
381 | <body-content>JSP</body-content> |
||
382 | <description> |
||
383 | <![CDATA[ |
||
384 | <p><strong>Put an attribute in enclosing attribute container tag.</strong></p> |
||
385 | <p> |
||
386 | Enclosing attribute container tag can be : |
||
387 | <ul> |
||
388 | <li><initContainer></li> |
||
389 | <li><definition></li> |
||
390 | <li><insertAttribute></li> |
||
391 | <li><insertDefinition></li> |
||
392 | <li><putListAttribute></li> |
||
393 | </ul> |
||
394 | (or any other tag which implements the <code>PutAttributeTagParent</code> interface. |
||
395 | Exception is thrown if no appropriate tag can be found.</p> |
||
396 | <p>Put tag can have following atributes : |
||
397 | <ul> |
||
398 | <li>name : Name of the attribute</li> |
||
399 | <li>value : value to put as attribute</li> |
||
400 | <li>type : value type. Possible type are : string (value is used as direct string), |
||
401 | template (value is used as a page url to insert), |
||
402 | definition (value is used as a definition name to insert), |
||
403 | object (value is used as it is)</li> |
||
404 | <li>role : Role to check when 'insertAttribute' will be called.</li> |
||
405 | </ul></p> |
||
406 | <p>Value can also come from tag body. Tag body is taken into account only if |
||
407 | value is not set by one of the tag attributes. In this case Attribute type is |
||
408 | "string", unless tag body define another type.</p> |
||
409 | ]]> |
||
410 | </description> |
||
411 | <attribute> |
||
412 | <name>name</name> |
||
413 | <required>true</required> |
||
414 | <rtexprvalue>true</rtexprvalue> |
||
415 | <description> |
||
416 | <![CDATA[ |
||
417 | <p>Name of the attribute.</p> |
||
418 | ]]> |
||
419 | </description> |
||
420 | </attribute> |
||
421 | <attribute> |
||
422 | <name>value</name> |
||
423 | <required>false</required> |
||
424 | <rtexprvalue>true</rtexprvalue> |
||
425 | <type>java.lang.Object</type> |
||
426 | <description> |
||
427 | <![CDATA[ |
||
428 | <p>Attribute value. Could be a String or an Object.</p> |
||
429 | ]]> |
||
430 | </description> |
||
431 | </attribute> |
||
432 | <attribute> |
||
433 | <name>type</name> |
||
434 | <required>false</required> |
||
435 | <rtexprvalue>false</rtexprvalue> |
||
436 | <description> |
||
437 | <![CDATA[ |
||
438 | <p>Specify content type: string, template or definition.</p> |
||
439 | <ul> |
||
440 | <li>string : Content is printed directly.</li> |
||
441 | <li>template : Content is included from specified URL. Value is used as an URL.</li> |
||
442 | <li>definition : Value is the name of a definition defined in factory (xml file). Definition will be searched |
||
443 | in the inserted tile, in a <code><tiles:insertAttribute name="attributeName"></code> tag, where 'attributeName' |
||
444 | is the name used for this tag.</li> |
||
445 | <li>object: the value is used as it is.</li> |
||
446 | </ul> |
||
447 | ]]> |
||
448 | </description> |
||
449 | </attribute> |
||
450 | <attribute> |
||
451 | <name>role</name> |
||
452 | <required>false</required> |
||
453 | <rtexprvalue>true</rtexprvalue> |
||
454 | <description> |
||
455 | <![CDATA[ |
||
456 | <p> |
||
457 | If the user is in the specified role, the tag is taken into account; |
||
458 | otherwise, the tag is ignored (skipped). |
||
459 | </p> |
||
460 | ]]> |
||
461 | </description> |
||
462 | </attribute> |
||
463 | </tag> |
||
464 | <tag> |
||
465 | <name>putListAttribute</name> |
||
466 | <tag-class>org.apache.tiles.jsp.taglib.PutListAttributeTag</tag-class> |
||
467 | <body-content>JSP</body-content> |
||
468 | <description> |
||
469 | <![CDATA[ |
||
470 | <p><strong>Declare a list that will be pass as attribute to tile. |
||
471 | </strong></p> |
||
472 | <p>Declare a list that will be pass as attribute to tile. |
||
473 | List elements are added using the tags 'addAttribute' or 'addListAttribute'. |
||
474 | This tag can only be used inside 'insertTemplate', 'insertDefinition', |
||
475 | 'definition' tags.</p> |
||
476 | ]]> |
||
477 | </description> |
||
478 | <attribute> |
||
479 | <name>name</name> |
||
480 | <required>true</required> |
||
481 | <rtexprvalue>true</rtexprvalue> |
||
482 | <description> |
||
483 | <![CDATA[ |
||
484 | <p>Name of the list.</p> |
||
485 | ]]> |
||
486 | </description> |
||
487 | </attribute> |
||
488 | </tag> |
||
489 | <tag> |
||
490 | <name>addAttribute</name> |
||
491 | <!-- |
||
492 | Intentionally PutTag, it doubles for the AddTag |
||
493 | The only difference between the two is that the name |
||
494 | is not used in the Add Tag (and it's only valid within |
||
495 | the PutList |
||
496 | --> |
||
497 | <tag-class>org.apache.tiles.jsp.taglib.AddAttributeTag</tag-class> |
||
498 | <body-content>JSP</body-content> |
||
499 | <description> |
||
500 | <![CDATA[ |
||
501 | <p><strong>Add an element to the surrounding list. |
||
502 | Equivalent to 'putAttribute', but for list element.</strong></p> |
||
503 | |||
504 | <p>Add an element to the surrounding list. |
||
505 | This tag can only be used inside 'putListAttribute' or 'addListAttribute' tags. |
||
506 | Value can come from a direct assignment (value="aValue")</p> |
||
507 | ]]> |
||
508 | </description> |
||
509 | <attribute> |
||
510 | <name>value</name> |
||
511 | <required>false</required> |
||
512 | <rtexprvalue>true</rtexprvalue> |
||
513 | <type>java.lang.Object</type> |
||
514 | <description> |
||
515 | <![CDATA[ |
||
516 | <p>Attribute value. Can be a String or Object.</p> |
||
517 | ]]> |
||
518 | </description> |
||
519 | </attribute> |
||
520 | <attribute> |
||
521 | <name>type</name> |
||
522 | <required>false</required> |
||
523 | <rtexprvalue>false</rtexprvalue> |
||
524 | <description> |
||
525 | <![CDATA[ |
||
526 | <p>Specify content type: string, template or definition.</p> |
||
527 | <ul> |
||
528 | <li>string : Content is printed directly.</li> |
||
529 | <li>template : Content is included from specified URL. Value is used as an URL.</li> |
||
530 | <li>definition : Value denote a definition defined in factory (xml file). Definition will be searched |
||
531 | in the inserted tile, in a <code><insertAttribute name="attributeName"></code> tag, where 'attributeName' |
||
532 | is the name used for this tag.</li> |
||
533 | <li>object: the value is used as it is.</li> |
||
534 | </ul> |
||
535 | ]]> |
||
536 | </description> |
||
537 | </attribute> |
||
538 | <attribute> |
||
539 | <name>role</name> |
||
540 | <required>false</required> |
||
541 | <rtexprvalue>true</rtexprvalue> |
||
542 | <description> |
||
543 | <![CDATA[ |
||
544 | <p>If the user is in the specified role, the tag is taken into account; |
||
545 | otherwise, the tag is ignored (skipped).</p> |
||
546 | ]]> |
||
547 | </description> |
||
548 | </attribute> |
||
549 | </tag> |
||
550 | <tag> |
||
551 | <name>addListAttribute</name> |
||
552 | <tag-class>org.apache.tiles.jsp.taglib.AddListAttributeTag</tag-class> |
||
553 | <body-content>JSP</body-content> |
||
554 | <description> |
||
555 | <![CDATA[ |
||
556 | <p><strong>Declare a list that will be pass as an attribute. |
||
557 | </strong></p> |
||
558 | <p>Declare a list that will be pass as an attribute . |
||
559 | List elements are added using the tag 'addAttribute' or 'addListAttribute'. |
||
560 | This tag can only be used inside 'insertTemplate', 'insertDefinition' |
||
561 | or 'definition' tag.</p> |
||
562 | ]]> |
||
563 | </description> |
||
564 | </tag> |
||
565 | <tag> |
||
566 | <name>getAsString</name> |
||
567 | <tag-class>org.apache.tiles.jsp.taglib.GetAsStringTag</tag-class> |
||
568 | <body-content>empty</body-content> |
||
569 | <description> |
||
570 | <![CDATA[ |
||
571 | <p><strong> |
||
572 | Render the value of the specified template attribute to the current JspWriter |
||
573 | </strong></p> |
||
574 | |||
575 | <p>Retrieve the value of the specified template attribute |
||
576 | property, and render it to the current JspWriter as a String. |
||
577 | The usual toString() conversions is applied on found value.</p> |
||
578 | <p>Throw a JSPException if named value is not found.</p> |
||
579 | ]]> |
||
580 | </description> |
||
581 | <attribute> |
||
582 | <name>name</name> |
||
583 | <required>true</required> |
||
584 | <rtexprvalue>true</rtexprvalue> |
||
585 | <description> |
||
586 | <![CDATA[ |
||
587 | <p>Attribute name.</p> |
||
588 | ]]> |
||
589 | </description> |
||
590 | </attribute> |
||
591 | <attribute> |
||
592 | <name>ignore</name> |
||
593 | <required>false</required> |
||
594 | <rtexprvalue>true</rtexprvalue> |
||
595 | <type>boolean</type> |
||
596 | <description> |
||
597 | <![CDATA[ |
||
598 | <p> |
||
599 | If this attribute is set to true, and the attribute specified by the name |
||
600 | does not exist, simply return without writing anything. The default value is false, which will |
||
601 | cause a runtime exception to be thrown. |
||
602 | </p> |
||
603 | ]]> |
||
604 | </description> |
||
605 | </attribute> |
||
606 | <attribute> |
||
607 | <name>role</name> |
||
608 | <required>false</required> |
||
609 | <rtexprvalue>true</rtexprvalue> |
||
610 | <description> |
||
611 | <![CDATA[ |
||
612 | <p> |
||
613 | If the user is in the specified role, the tag is taken into account; |
||
614 | otherwise, the tag is ignored (skipped). |
||
615 | </p> |
||
616 | ]]> |
||
617 | </description> |
||
618 | </attribute> |
||
619 | </tag> |
||
620 | <tag> |
||
621 | <name>useAttribute</name> |
||
622 | <tag-class>org.apache.tiles.jsp.taglib.UseAttributeTag</tag-class> |
||
623 | <tei-class>org.apache.tiles.jsp.taglib.UseAttributeTag$Tei</tei-class> |
||
624 | <body-content>empty</body-content> |
||
625 | <description> |
||
626 | <![CDATA[ |
||
627 | <p><strong>Use attribute value inside page.</strong></p> |
||
628 | <p>Declare a Java variable, and an attribute in the specified scope, |
||
629 | using its attribute value.</p> |
||
630 | <p>Java variable and attribute will have the name specified by 'id', |
||
631 | or the original name if not specified.</p> |
||
632 | ]]> |
||
633 | </description> |
||
634 | <attribute> |
||
635 | <name>id</name> |
||
636 | <required>false</required> |
||
637 | <rtexprvalue>true</rtexprvalue> |
||
638 | <description> |
||
639 | <![CDATA[ |
||
640 | <p>Declared attribute and variable name.</p> |
||
641 | ]]> |
||
642 | </description> |
||
643 | </attribute> |
||
644 | <attribute> |
||
645 | <name>classname</name> |
||
646 | <required>false</required> |
||
647 | <rtexprvalue>true</rtexprvalue> |
||
648 | <description> |
||
649 | <![CDATA[ |
||
650 | <p>Class of the declared variable.</p> |
||
651 | ]]> |
||
652 | </description> |
||
653 | </attribute> |
||
654 | <attribute> |
||
655 | <name>scope</name> |
||
656 | <required>false</required> |
||
657 | <rtexprvalue>false</rtexprvalue> |
||
658 | <description> |
||
659 | <![CDATA[ |
||
660 | <p>Scope of the declared attribute. Default to 'page'.</p> |
||
661 | ]]> |
||
662 | </description> |
||
663 | </attribute> |
||
664 | <attribute> |
||
665 | <name>name</name> |
||
666 | <required>true</required> |
||
667 | <rtexprvalue>true</rtexprvalue> |
||
668 | <description> |
||
669 | <![CDATA[ |
||
670 | <p>Attribute name.</p> |
||
671 | ]]> |
||
672 | </description> |
||
673 | </attribute> |
||
674 | <attribute> |
||
675 | <name>ignore</name> |
||
676 | <required>false</required> |
||
677 | <rtexprvalue>true</rtexprvalue> |
||
678 | <type>boolean</type> |
||
679 | <description> |
||
680 | <![CDATA[ |
||
681 | <p> |
||
682 | If this attribute is set to true, and the attribute specified by the name |
||
683 | does not exist, simply return without error. The default value is false, which will |
||
684 | cause a runtime exception to be thrown. |
||
685 | </p> |
||
686 | ]]> |
||
687 | </description> |
||
688 | </attribute> |
||
689 | </tag> |
||
690 | <tag> |
||
691 | <name>importAttribute</name> |
||
692 | <tag-class>org.apache.tiles.jsp.taglib.ImportAttributeTag</tag-class> |
||
693 | <body-content>empty</body-content> |
||
694 | <description> |
||
695 | <![CDATA[ |
||
696 | <p><strong>Import attribute(s) in specified context.</strong></p> |
||
697 | <p>Import attribute(s) to requested scope. |
||
698 | Attribute name and scope are optional. If not specified, all |
||
699 | attributes are imported in page scope. |
||
700 | Once imported, an attribute can be used as any other beans from jsp |
||
701 | contexts.</p> |
||
702 | ]]> |
||
703 | </description> |
||
704 | <attribute> |
||
705 | <name>name</name> |
||
706 | <required>false</required> |
||
707 | <rtexprvalue>true</rtexprvalue> |
||
708 | <description> |
||
709 | <![CDATA[ |
||
710 | <p>Attribute name. If not specified, all attributes are |
||
711 | imported.</p> |
||
712 | ]]> |
||
713 | </description> |
||
714 | </attribute> |
||
715 | <attribute> |
||
716 | <name>toName</name> |
||
717 | <required>false</required> |
||
718 | <rtexprvalue>true</rtexprvalue> |
||
719 | <description> |
||
720 | <![CDATA[ |
||
721 | <p>Name of the destination bean. If not specified, the name will |
||
722 | be the same as specified in <code>name</code> attribute</p> |
||
723 | ]]> |
||
724 | </description> |
||
725 | </attribute> |
||
726 | <attribute> |
||
727 | <name>scope</name> |
||
728 | <required>false</required> |
||
729 | <rtexprvalue>false</rtexprvalue> |
||
730 | <description> |
||
731 | <![CDATA[ |
||
732 | <p>Scope into which attribute is imported. Default to page.</p> |
||
733 | ]]> |
||
734 | </description> |
||
735 | </attribute> |
||
736 | <attribute> |
||
737 | <name>ignore</name> |
||
738 | <required>false</required> |
||
739 | <rtexprvalue>true</rtexprvalue> |
||
740 | <type>boolean</type> |
||
741 | <description> |
||
742 | <![CDATA[ |
||
743 | <p>If this attribute is set to true, and the attribute specified by |
||
744 | the name does not exist, simply return without error. The default |
||
745 | value is false, which will cause a runtime exception to be thrown.</p> |
||
746 | ]]> |
||
747 | </description> |
||
748 | </attribute> |
||
749 | </tag> |
||
750 | <tag> |
||
751 | <name>initContainer</name> |
||
752 | <tag-class>org.apache.tiles.jsp.taglib.definition.InitContainerTag</tag-class> |
||
753 | <body-content>JSP</body-content> |
||
754 | <description> |
||
755 | <![CDATA[ |
||
756 | <p><strong>Initialize the TilesContainer.</strong></p> |
||
757 | <p> |
||
758 | In order to use the Tiles system, a TilesContainer must be instantiated. |
||
759 | This initialization is generally done by the TilesListener (or perhaps the |
||
760 | TilesServlet or TilesFilter). |
||
761 | </p> |
||
762 | <p> |
||
763 | If the intialization needs to be dynamic, you can initialize the container using |
||
764 | this tag. Realize however, that this tag MUST be executed prior to invoking |
||
765 | any other definitions. Additionally, the initilization may only be done once, |
||
766 | and any subsequent invocations will be ignored. |
||
767 | </p> |
||
768 | ]]> |
||
769 | </description> |
||
770 | <attribute> |
||
771 | <name>containerFactory</name> |
||
772 | <required>false</required> |
||
773 | <rtexprvalue>true</rtexprvalue> |
||
774 | <description> <![CDATA[ <p>Container Factory implementation used to instantiate the container.</p> ]]> </description> |
||
775 | </attribute> |
||
776 | </tag> |
||
777 | |||
778 | <tag> |
||
779 | <name>destroyContainer</name> |
||
780 | <tag-class>org.apache.tiles.jsp.taglib.definition.DestroyContainerTag</tag-class> |
||
781 | <body-content>empty</body-content> |
||
782 | <description> |
||
783 | <![CDATA[ |
||
784 | <p><strong>Destroy the TilesContainer.</strong></p> |
||
785 | ]]> |
||
786 | </description> |
||
787 | </tag> |
||
788 | </taglib> |
||
789 |