Subversion Repositories Sigmater

Rev

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>&lt;tiles:insertTemplate&gt;</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>&lt;tiles:putAttribute&gt;</code> or
51
      <code>&lt;tiles:putListAttribute&gt;</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
          &lt;tiles:insertTemplate template="/basic/myLayout.jsp" flush="true"&gt;
59
             &lt;tiles:putAttribute name="title" value="My first page" /&gt;
60
             &lt;tiles:putAttribute name="header" value="/common/header.jsp" /&gt;
61
             &lt;tiles:putAttribute name="footer" value="/common/footer.jsp" /&gt;
62
             &lt;tiles:putAttribute name="menu" value="/basic/menu.jsp" /&gt;
63
             &lt;tiles:putAttribute name="body" value="/basic/helloBody.jsp" /&gt;
64
          &lt;/tiles:insert&gt;
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>&lt;tiles:insertDefinition&gt;</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>&lt;tiles:putAttribute&gt;</code> or
142
      <code>&lt;tiles:putListAttribute&gt;</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
          &lt;tiles:insertDefinition name=".my.tiles.defininition flush="true"&gt;
150
             &lt;tiles:putAttribute name="title" value="My first page" /&gt;
151
             &lt;tiles:putAttribute name="header" value="/common/header.jsp" /&gt;
152
             &lt;tiles:putAttribute name="footer" value="/common/footer.jsp" /&gt;
153
             &lt;tiles:putAttribute name="menu" value="/basic/menu.jsp" /&gt;
154
             &lt;tiles:putAttribute name="body" value="/basic/helloBody.jsp" /&gt;
155
          &lt;/tiles:insertDefinition&gt;
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
          &lt;tiles:insertAttribute name="body" /&gt;
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>&lt;initContainer&gt;</li> 
389
		<li>&lt;definition&gt;</li> 
390
		<li>&lt;insertAttribute&gt;</li> 
391
		<li>&lt;insertDefinition&gt;</li>
392
		<li>&lt;putListAttribute&gt;</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>&lt;tiles:insertAttribute name="attributeName"&gt;</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>&lt;insertAttribute name="attributeName"&gt;</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