<taglib version="2.0" xmlns="http://java.sun.com/xml/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">

<taglib>
  ... body of taglib descriptor ...
</taglib>

<tlib-version>version_number</tlib-version>

(必須) タグ ライブラリのバージョン番号。

<jsp-version>version_number</jsp-version>

(必須) このタグ ライブラリが機能するために必要な JSP 仕様のバージョン (番号) を記述します。デフォルトは 2.0 です。

<short-name>TagLibraryName</short-name>

(必須) タグ ライブラリに短縮名を割り当てます。この要素は、WebLogic Server では使用されません。

<uri>unique_string</uri>

(必須) このバージョンのタグ ライブラリをユニークに識別するパブリックな URI を定義します。

<display-name>display_name</display-name>

(省略可能) ツールによって表示される短縮名を指定します。

<icon>

<small-icon>icon.jpg</small-icon>

   (省略可能) 小さいアイコン (16x16) の画像が含まれるファイルの名前を指定します。
   ファイル名はタグ ライブラリ内の相対パスです。画像は JPEG または GIF 形式で、
   ファイル名はそれぞれ「.jpg」または「.gif」というサフィックスで終わる必要があります。
   アイコンはツールによって使用されます。

<large-icon>icon.jpg</large-icon>

   (省略可能) 大きいアイコン (32x32) の画像が含まれるファイルの名前を指定します。
   ファイル名はタグ ライブラリ内の相対パスです。画像は JPEG または GIF 形式で、
   ファイル名はそれぞれ「.jpg」または「.gif」というサフィックスで終わる必要があります。
   アイコンはツールによって使用されます。

</icon>

<description>...text...</description>

(必須) タグ ライブラリについて説明する任意のテキスト文字列を定義します。

<validator>unique_string</validator>

(省略可能) このタグでスクリプト変数の情報を定義します。1 つまたは複数の変数の下位要素を持つタグに、null 以外のオブジェクトを返す TagExtraInfo クラスがある場合には、変換時エラーが発生します。

<listener>unique_string</listener>

(省略可能) 自動的にインスタンス化および登録される任意のイベント リスナ オブジェクトを定義します。

<validator>

<validator-class>my.validator</validator-class>

   (必須) 検証を実行する Java クラス。

<init-param>

   (省略可能) バリデータ クラスの初期化パラメータを定義します。

<param-name>param</param-name>

   このパラメータの名前を定義します。

<param-value>value</param-value>

   このパラメータの名前を定義します。

タグ ライブラリに新しいタグを定義するには、それぞれ別個の <tag> 要素を使用します。<tag> 要素には、以下のネスト タグを埋め込むことができます。

<name>tag_name</name>

(必須) タグの名前を指定します。JSP ファイルのタグを参照するときに、次のように「:」という記号の後に使用します。

<mytaglib:tag_name>

詳細については、「このリリースでの JSP の新機能と変更点」を参照してください。

<tag-class>package.class.name</tag-class>

(必須) このタグの機能を実装するタグ ハンドラ クラスを宣言します。そのクラスの完全修飾パッケージ名を指定します。

クラス ファイルは、WEB-INF/classes ディレクトリの下に、パッケージ名を反映したディレクトリ構造に従って配置します。タグ ライブラリ jar ファイルにクラスをパッケージ化することもできます。詳細については、「JSP タグ ライブラリの JAR ファイルとしてのパッケージ化」を参照してください。

<tei-class>package.class.name</tei-class>

(省略可能) このタグによって導入されるスクリプト変数を記述する TagExtraInfo のサブクラスを宣言します。タグが新しいスクリプト変数を定義しない場合、この要素は使われません。そのクラスの完全修飾パッケージ名を指定します。このクラスに含まれるタグの属性を検証できます。

クラス ファイルは、Web アプリケーションの WEB-INF/classes ディレクトリの下に、パッケージ名を反映したディレクトリ構造に従って配置します。タグ ライブラリ jar ファイルにクラスをパッケージ化することもできます。詳細については、「JSP タグ ライブラリの JAR ファイルとしてのパッケージ化」を参照してください。

<body-content>empty | JSP | scriptless | tagdependent</body-content>

(省略可能) タグ本体のコンテンツを定義します。

empty を指定すると、タグは JSP ページ内で空タグ フォーマットで使用されます。次に例を示します。<taglib:tagname/>

JSP を指定すると、タグのコンテンツは JSP として解釈され、タグは本体付きフォーマットで使用しなければなりません。次に例を示します。

<taglib:tagname>...</taglib:tagname>

scriptless を指定すると、タグのコンテンツにはスクリプトやスクリプト記述要素が一切含まれません。

tagdependent を指定すると、タグは本体のコンテンツを JSP 以外のもの (たとえば SQL 文) であると解釈します。

<attribute>

   (省略可能) JSP ページ内のタグ要素に指定できる属性の名前を定義します。次に例を示します。

   <taglib:mytag myAttribute="myAttributeValue">

   タグに指定できる属性を定義するには、それぞれ別個の <attribute> 要素を使用します。タグ属性を使用すると、JSP 作成者はタグの動作を変更できます。

   <name>myAttribute</name>

   <required>true | false</required>

      (省略可能) この属性が JSP ページの中でオプションとして使用されるかどうかを定義します。

      ここで定義しない場合、デフォルトは false、つまりその属性は省略可能となります。      

      true が指定され、その属性が JSP ページの中で使用されない場合、変換時エラーが
      発生します。

   <rtexprvalue>true | false</rtexprvalue>

      (省略可能) この属性の値としてスクリプトレット式を指定して、要求時にそれを動的に
      計算できるようにするかどうかを定義します。

      この要素を指定しない場合、デフォルトとして false が使用されます。

</attribute>

<tag> 要素内にスクリプト変数を定義できます。

<variable>

変数の宣言の最上位要素。

<name-given>someName</name-given>

   変数の名前を定義します。使用する属性から名前を定義できます。

<name-from-attribute>attrName</name-from-attribute>

   attrName の値を使用して変数の名前を指定します。

<variable-class>some.java.type</variable-class>

   この変数の Java タイプ。

<declare>true</declare>

   (省略可能) true に設定する場合、変数が定義されることを示します。

<scope>AT_BEGIN</scope>

   スクリプト変数のスコープ。有効なオプションは以下のとおりです。

   NESTED (変数はタグ本体の内部でのみ使用できます)

   AT_BEGIN (変数は本体を実行する直前に定義されます)

   AT_END (変数は本体を実行した直後に定義されます)

</variable>