Contents | Prev | Next


Tag Directive

Used for declaring custom tag properties.

JSP Syntax

<%@ tag   	
[ display-name="name of the tag file | display-name" ]
[ body-content="scriptless|tagdependent|empty" ]
[ dynamic-attributes="page-scoped attribute" ]
[ small-icon="relativeURL" ]
[ large-icon="relativeURL" ]
[ description="text" ]
[ example="text" ]
[ language="java" ]
[ import="{package.class | package.*} , ... " ]
[ pageEncoding="{characterSet | ISO-8859-1}" ]
[ isELIgnored="true|false" ]	
%>

OR

<jsp:directive.tag tagDirectiveAttrList />
where tagDirectiveAttrList is the same as the attribute list in the JSP syntax.

XML Syntax

<jsp:directive.tag tagDirectiveAttrList />

where tagDirectiveAttrList is the same as the attribute list in the JSP syntax.

Examples

This tag accepts an arbitrary number of attributes whose values are colors and outputs a bulleted list of the attributes colored according to the values:

<colored:colored color1="red" color2="yellow" color3="blue"/>

The following code implements the preceding tag. An arbitrary number of attributes whose values are colors are stored in a Map named by the dynamic-attributes attribute of the tag directive. The JSTL forEach tag is used to iterate through the Map and the attribute keys and colored attribute values are printed in a bulleted list.

<%@ tag dynamic-attributes="colorMap"%>	
<ul>	
<c:forEach var="color" begin="0" items="${colorMap}">	
<li>${color.key} = <font color="${color.value}">${color.value}</
font><li>	
</c:forEach>	
</ul>

Description

The tag directive is similar to the page directive in a JSP page, but applies to tag files instead of JSP pages. As with the page directive, a translation unit can contain more than one instance of the tag directive. All the attributes apply to the complete translation unit. However, there can be only one occurrence of any attribute or value defined by this directive in a given translation unit. With the exception of the import attribute, multiple attribute or value (re)definitions result in a translation error.

Attributes



Contents | Prev | Next

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