| < Day Day Up > |
|
The <tiles:insert /> tag is used to insert a Tiles template into a JSP. You must use the <tiles:put /> or <tiles:putList /> tags to substitute sub-components of the tile being inserted. The <tiles:insert /> tag has a body type of JSP and supports 14 attributes, described in Table 17.1.
Attribute | Description |
---|---|
template | A URI identifying a predefined template or tile that will be inserted into the current page. (Optional) |
component | The relative or absolute path of a component that you want to insert into the JSP. (Optional) |
page | The relative or absolute path of a JSP that you want to insert into the containing JSP. (Optional) |
definition | The name of a predefined Tiles template that you want to insert into the containing JSP. (Optional) |
attribute | The name of an attribute in the Tiles context. The retrieved value is passed to the entity defined by the name attribute. (Optional) |
name | The name of the Tiles object being inserted into this page. (Optional) |
beanName | The name of a JavaBean that will be used as the value of the name attribute. The JavaBean is retrieved from the appropriate scope, if not specified, using the PageContext.findAttribute() method. (Optional) |
beanProperty | Used in conjunction with the beanName attribute to identify a JavaBean property that will be used as the value of the name attribute as opposed to the JavaBean itself. (Optional) |
beanScope | The scope of the JavaBean identified by the beanName attribute. (Optional) |
flush | If true, then the output stream of the containing JSP is writing to the client prior to the insertion of the template identified by this tag. (Optional) |
ignore | If this attribute is true and the Tiles object identified by the name attribute is not found, then this tag is not evaluated. (Optional) |
role | The required role for evaluating this <tiles:insert /> tag. If the requesting user is not in the named role, then this tag is ignored. (Optional) |
controllerUrl | The URL of a Controller class that is invoked prior to the insertion of the template identified by this tag. (Optional) |
controllerClass | A fully qualified class that is invoked prior to the insertion of the template named by this <tiles:insert /> tag. The named class must be an extension of an org.apache.struts.tiles.Controller, org.apache.struts.tiles.ControllerSupport, or org.apache.struts.action.Action class. (Optional) |
When using the <tiles:insert /> tag, you must use the template, component, page, definition, attribute, or name attribute.
| < Day Day Up > |
|