JSF HTMLライブラリ - <h:commandButton>タグ

フォームをアプリケーションに発行するUIボタンを作成します。コンポーネントは、HTML <input>要素としてレンダリングされます。そのtype属性は、このアクション要素のtypeの値およびimage属性値に応じて"submit"、"reset"または"image"に設定され、name属性はコンポーネントのクライアントIDに、value属性はコンポーネントの値にそれぞれ設定されます。

構文

<h:commandButton value="value"
	[id="id"]
	[binding="componentBinding"]
	[rendered="true|false"]
	[image="imageURL"]
	[type="submit|reset"]
	[action="actionMethodBinding"]
	[actionListener="actionlistenerBinding"]
	[immediate="true|false"]
	<!--HTML attributes-->
/>    

説明

id
文字列。このコンポーネントのコンポーネント識別子。値は、ネーミング・コンテナである最も近い親コンポーネント内で一意である必要があります。
value
オブジェクト。このコンポーネントの現在の値。
rendered
ブール値。レンダー・レスポンス・フェーズ中にこのコンポーネントをレンダリングするかどうか、または後続のフォーム発行でこのコンポーネントを処理するかどうかを示すフラグ。
type
文字列。作成するボタンのタイプ。有効な値は"submit"と"reset"です。指定しない場合、または有効な値でない場合、デフォルト値は"submit"です。
image
文字列。このボタンに対して表示されるイメージの絶対または相対URL。指定した場合、この入力要素のタイプは"image"になります。指定しない場合は、typeプロパティで指定したタイプになり、ラベルはvalueプロパティで指定したラベルになります。
immediate
ブール値。このコンポーネントの値は、検証処理フェーズまで待機するのではなく、リクエストの適用フェーズ中に変換および検証される必要があることを示すフラグ。
action
文字列。ユーザーがこのコンポーネントをアクティブにすると起動するアプリケーション・アクションを表すMethodBinding。式では、パラメータを取らないpublicメソッドを評価し、このアプリケーションのNavigationHandlerに渡されるStringを戻す必要があります。
actionListener
文字列。ユーザーがこのコンポーネントをアクティブにすると通知を受け取るアクション・リスナー・メソッドを表すMethodBinding。式では、ActionEventパラメータを取るpublicメソッドを評価し、戻り型がvoidである必要があります。
binding
文字列。このコンポーネントをバッキングBeanのプロパティにリンクする値バインディング式。

JSFでサポートされているHTML 4.01属性(オプション)については、「JSF標準コンポーネントのタグ属性の概要」を参照してください。

このタグおよびすべてのJSF Core要素とHTML要素の詳細は、次のURLの「W3C JavaServer Faces 1.1 Specification」を参照してください。
http://java.sun.com/j2ee/javaserverfaces/1.1/docs/tlddocs/index.html


リファレンス: JSF標準コンポーネント