JavaServer Pages, 3rd Edition

Name

Tag Directive

Synopsis

This directive can only be used in tag files. It defines properties of the file itself, such as encoding and how to treat EL expressions, as well as properties of the custom action the tag file implements the behavior for, such as developer information an authoring tool can display.

Syntax

<%@ tag [body-content="empty|scriptless|tagdependent"]
  [description="description"] [display-name="displayName"]
  [dynamic-attributes="attrCollVar"] [example="example"]
  [import="packageList"] [isELIgnored="true|false"] [language="java|language"]
  [large-icon="largeIconPath"] [pageEncoding="encoding"]
  [small-icon="smallIconPath"]
%>

Attributes

Attribute name	Default	Description
body-content	scriptless	The custom action body content type, one of empty, scriptless, or tagdependent.
description	No default	A description of the custom action that can be displayed by a page-authoring tool.
display-name	No default	A descriptive name for the custom action that can be displayed by a page-authoring tool.
dynamic-attributes	No default	The name of a variable to hold undeclared attributes. The variable is made available in the tag file’s page scope as a java.util.Map with the attribute names as keys and the attribute values as the values.
example	No default	An example of how to use the custom action that can be displayed by a page-authoring tool.
import	No default	A Java import declaration, i.e., a comma-separated list of fully qualified class names or package names ...