tiles
Tag insertTemplate


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:insert>  


    Tag Information
    Tag Classorg.apache.tiles.jsp.taglib.InsertTemplateTag
    TagExtraInfo ClassNone
    Body ContentJSP
    Display NameNone

    Attributes
    NameRequiredRequest-timeTypeDescription
    templatetruetruejava.lang.String

    A string representing the URI of a template (for example, a JSP page).

    flushfalsefalseboolean

    True or false. If true, current page out stream is flushed before insertion.

    ignorefalsetrueboolean

    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.

    rolefalsetruejava.lang.String

    If the user is in the specified role, the tag is taken into account; otherwise, the tag is ignored (skipped).

    preparerfalsetruejava.lang.StringThe fully qualified class name of the preparer.

    Variables
    No Variables Defined.


    Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.