入力コンポーネント

Java™ ウィジェット・ライブラリー (JWL) 入力コンポーネントは、ユーザーと対話して、対話の結果を処理のためにサーバーに送信するために使用されます。

使用可能な入力タグは以下のとおりです。

この表では、パレットで最初は非表示になっているコンポーネントの名前の横には、アスタリスク (*) が付けられています。

表 1. 入力コンポーネント
コンポーネント タグ名 説明
入力 <h:inputText> 数値、日付、時刻、またはフォーマット済み文字列などのテキストまたはフォーマット済みテキストを入力するために使用される、単一行入力コントロールを作成します。 このコントロールには、キー・ストローク管理、先行入力サポート、ヘルパー・ボタンなどの、 さまざまな種類の入力支援コンポーネントを付加することができます。 入力コンポーネントについて詳しくは、『Faces JSP ファイルへの入力コンポーネントの追加』を参照してください。 以下のタイプのデータ用に入力フィールドを作成できます。
  • inputText
  • convertNumber
  • convertDateTime
  • convertMask
入力 - テキスト領域 <h:inputTextarea> 長い、フォーマットされていないテキストを入力するために使用される、 複数行入力コントロールを作成します。
入力 - リッチ・テキスト領域 <r:inputRichText> リッチ・テキスト・エディターのコンポーネントを挿入します。 「入力 - テキスト領域」コンポーネントと同様、 このコンポーネントは複数行にテキストを持つことができます。 「入力テキスト領域」とは異なり、 このコンポーネントにはさまざまなフォント、サイズ、テーブル、リンク、 番号付リスト、順不同リストなどを含めることが可能です。
ヘルパー - 日付ピッカー <hx:inputHelperDatePicker> inputText フィールドに日付ピッカー・ヘルパー・ボタンを追加します。 ヘルパー・ボタンをクリックすると、 日付の選択に使用できるカレンダーを含むポップアップが表示されます。
ヘルパー - スライダー <hx:inputHelperSlider> inputText フィールドに数値スライダー・ヘルパー・ボタンを追加します。 ヘルパー・ボタンをクリックすると、 数値の選択に使用できる「スライダー」を含むポップアップが表示されます。
ヘルパー - スピナー <hx:inputHelperSpinner> inputText フィールドに上と下のスピナー・ボタンのペアを追加します。 スピナー・ボタンをクリックすると、数値または時刻値が増減します。
*入力 - 非表示 <h:inputHidden> 非表示の入力コンポーネントを挿入します。 このコンポーネントは、開発者が ページ間またはページ上のコントロール間でデータを受け渡す際に、 よく使用されます。
入力 - パスワード <h:inputSecret> パスワード入力フィールドをページに追加します。 このフィールドに入力されたテキストは変更された形式 (通常はアスタリスク) でユーザーにエコーされ、ブラウザーは他のプログラムに対し、パスワードが平文としてアクセスされないように保護しようとします。
ファイル・アップロード <hx:fileupload> ファイルをアップロードするための入力フィールドと、 関連する「参照」ボタンを表示します。 ファイル・アップロード・コンポーネントについて 詳しくは、『ファイル・アップロード・ コンポーネントの使用』を参照してください。
選択 - カレンダー <h:inputMiniCalendar> 小さなカレンダーをページに追加します。ユーザーは、カレンダー内の日付をクリックすることにより、日付を選択できます。
チェック・ボックス <h:selectBooleanCheckbox> ラベルのない Boolean 型チェック・ボックスを作成します。このコンポーネントについて詳しくは、 『Faces JSP ファイルへの選択リストの追加』を 参照してください。
チェック・ボックス・グループ <h:hx:selectManyCheckbox> ラベル付きのチェック・ボックスのセットを作成します。 ユーザーは、ボタンのリストからゼロ個またはそれ以上のボタンを選択できます。 このコンポーネントについて詳しくは、『Faces JSP ファイルへの選択リストの追加』を参照してください。
ラジオ・ボタン・グループ <h:selectOneRadio> ラベル付きのラジオ・ボタンのグループを作成します。 ユーザーは、ボタンのリストから 1 つを選択できます。 このコンポーネントについて詳しくは、『Faces JSP ファイルへの選択リストの追加』を参照してください。
コンボ・ボックス <h:selectOneMenu> ユーザーが 1 つの項目を選択するドロップダウン・コンボ・ボックスを表示します。 コンボ・ボックスの入力フィールドは直接編集することはできません。このコンポーネントについて詳しくは、『Faces JSP ファイルへの選択リストの追加』を参照してください。
色の選択 <h:selectOneColor> ユーザーが色を選択できるドロップダウン・コンボ・ボックスを表示します。 コンボ・ボックスの入力フィールドは直接編集することはできません。
リスト・ボックス - 複数選択 <h:selectManyListbox> ユーザーが複数の項目を選択できるリスト・ボックスを挿入します。 このコンポーネントについて詳しくは、 『Faces JSP ファイルへの選択リストの追加』を 参照してください。
リスト・ボックス - 単一選択 <h:selectOneListbox> ユーザーが単一の項目を選択するリスト・ボックスを挿入します。 このコンポーネントについて詳しくは、『Faces JSP ファイルへの選択リストの追加』を参照してください。
関連概念
非同期の JavaScript コンポーネントおよび XML (AJAX) コンポーネント
JavaServer Faces (JSF) の概要
JSF ウィジェット・ライブラリー (JWL)
JavaServer Faces (JSF) を使用した Web アプリケーションの開発
関連タスク
入力フィールドのカスタム・パターンの定義

フィードバック