Contents | Prev | Next


<jsp:element>

Dynamically generates an XML element.

JSP Syntax

(<jsp:element name="elementName"	
 ( /> | >  ( any elements or text </jsp:element> ))
) 
| ( <jsp:element name="elementName">
       [ <jsp:attribute name="attributeName" 	
         [ trim="true | false" ]
      ( /> | (any elements or text </jsp:attribute> ) ) ]+ 
      [ <jsp:body> any elements or text </jsp:body> ]
    </jsp:element>
  )

XML Syntax

Same as JSP syntax.

Examples

This example generates an HTML header tag with a lang attribute:

<jsp:element name="${content.headerName}"	
   xmlns:jsp="http://java.sun.com/JSP/Page">	
   <jsp:attribute name="lang">${content.lang}</jsp:attribute>	
   <jsp:body>${content.body}</jsp:body>	
</jsp:element>

The name attribute identifies the generated tag's name. The jsp:attribute tag generates the lang attribute. The body of the jsp:attribute tag identifies the value of the lang attribute. The jsp:body tag generates the body of the tag. The output of this example jsp:element could be:

<h1 lang="fr">Heading in French</h1>

Description

The jsp:element action is used to dynamically define the value of the tag of an XML element. This action can be used in JSP pages, tag files and JSP documents.

A jsp:element action has one mandatory attribute, name, of type String. The value of the name attribute is used as that of the tag of the element generated. The jsp:element action can have a body. Two forms are valid, depending on whether the element is to have attributes or not. In the first form, no attributes are present:

<jsp:element name="name">	
   optional body	
</jsp:element>

In the second form, zero or more attributes are requested, using jsp:attribute and jsp:body, as appropriate.

<jsp:element name="name">	
   [jsp:attribute]+	
   [jsp:body]	
</jsp:element>

The one valid, mandatory, attribute of jsp:element is its name. Unlike other standard actions, the value of the name attribute must be given as an XML-style attribute and cannot be specified using jsp:attribute This is because jsp:attribute has a special meaning when used in the body of jsp:element.

Attributes

See Also



Contents | Prev | Next

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.