TOC

JSF 2.0のカスタムタグ

JSF 2.0のカスタムタグ

JSF 2.0では、カスタムタグを作成して、事前定義されたコンテンツをレンダリングできます。 カスタムタグは通常のJSFタグのように見え、「ui:composition」を使用してコンテンツをページに挿入します。

JSF 2.0でカスタムタグを作成する手順の概要は次のとおりです。

  1. ：ui：compisition”タグを使用して、XHTMLページに定義済みのコンテンツを作成します。

  2. タグライブラリ記述子でカスタムタグを宣言します。

  3. タグライブラリ記述子をweb.xmlに登録します。

カスタムタグの例

カスタムタグを作成するためのガイド。ページに2つの定義済みの送信ボタンとリセットボタンを挿入します。

1. カスタムタグ

通常のXHTMLファイルを作成してカスタムタグを実装します。カスタムタグは、「ui：composition」タグを使用して、送信ボタンとリセットボタンをグループ化します。

WEB-INF/tags/com/example/button.xhtml

2. タグライブラリ

タグライブラリ記述子ファイルでカスタムタグの詳細を定義します。

  1. namespace –このタグライブラリの名前空間。競合を避けるために一意の名前を作成します。

  2. tag-name –カスタムタグ名。

  3. source –カスタムタグの実装。

WEB-INF\example.taglib.xml



    http://example.com/facelets
    
    button
    tags/com/example/button.xhtml

3. web.xmlに登録する

タグライブラリをweb.xmlファイルに登録します。 

 
 
    facelets.LIBRARIES
    /WEB-INF/example.taglib.xml

4. カスタムタグを使用

カスタムタグを使用するには、その名前空間を上で宣言し、通常のJSFタグのように使用する必要があります。 



    
        
Custome Tags in JSF 2.0

「example：button」カスタムタグは、1つの送信ボタンと1つのリセットボタンをレンダリングします。

jsf2-custom-tag—​example

ソースコードをダウンロード

ダウンロード–JSF-2-Custom-Tag-Example.zip（11KB）

Related