| |||||||
| FRAMES NO FRAMES | |||||||
Insert a template.
Insert a template with the possibility to pass parameters (called attributes). A template can be seen as a procedure that can take parameters or attributes. <tiles:insertTemplate> allows to define these attributes and pass them to the inserted jsp page, called template. Attributes are defined using nested tag <tiles:putAttribute> or <tiles:putListAttribute>.
You must specify template attribute, for inserting a template
Example :
<tiles:insertTemplate template="/basic/myLayout.jsp" flush="true"> <tiles:putAttribute name="title" value="My first page" /> <tiles:putAttribute name="header" value="/common/header.jsp" /> <tiles:putAttribute name="footer" value="/common/footer.jsp" /> <tiles:putAttribute name="menu" value="/basic/menu.jsp" /> <tiles:putAttribute name="body" value="/basic/helloBody.jsp" /> </tiles:insertTemplate> | Tag Information | |
| Tag Class | org.apache.tiles.jsp.taglib.InsertTemplateTag |
| TagExtraInfo Class | None |
| Body Content | scriptless |
| Display Name | None |
| Attributes | ||||
| Name | Required | Request-time | Type | Description |
| template | true | true | java.lang.String | A string representing the URI of a template (for example, a JSP page). |
| templateType | false | true | java.lang.String | The type of the template attribute. |
| templateExpression | false | false | java.lang.String | The expression to evaluate to get the value of the template. If used together with |
| flush | false | false | boolean | True or false. If true, current page out stream is flushed after insertion. |
| ignore | false | true | boolean | If this attribute is set to true, and the attribute specified by the name does not exist, simply return without writing anything. The default value is false, which will cause a runtime exception to be thrown. |
| role | false | true | java.lang.String | If the user is in the specified role, the tag is taken into account; otherwise, the tag is ignored (skipped). |
| preparer | false | true | java.lang.String | The fully qualified class name of the preparer. |
| Variables | No Variables Defined. |
| |||||||
| FRAMES NO FRAMES | |||||||