tiles:insert

---

<tiles:insert />

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.

Table 17.1: <tiles:insert /> Tag Attributes

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.

---