| |||||||
| FRAMES NO FRAMES | |||||||
Insert a definition.
Insert a definition with the possibility to override and specify parameters (called attributes). A definition can be seen as a (partially or totally) filled template that can override or complete attribute values. <tiles:insertDefinition> 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 name tag attribute, for inserting a definition from definitions factory.
Example :
<tiles:insertDefinition name=".my.tiles.defininition 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:insertDefinition> | Tag Information | |
| Tag Class | org.apache.tiles.jsp.taglib.InsertDefinitionTag |
| TagExtraInfo Class | None |
| Body Content | scriptless |
| Display Name | None |
| Attributes | ||||
| Name | Required | Request-time | Type | Description |
| name | true | true | java.lang.String | Name of the definition to insert. |
| template | false | true | java.lang.String | A string representing the URI of a template (for example, a JSP page) that will override the one used by the definition itself. |
| 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 preparer. |
| Variables | No Variables Defined. |
| |||||||
| FRAMES NO FRAMES | |||||||