Faces JSP ページへの入力コンポーネントの追加

Faces JSP ページに追加する入力コンポーネントは、ユーザーが Web アプリケーションのデータを作成および更新する方法を提供します。パレットの Faces コンポーネント・ドロワーの入力コンポーネントには、「入力」、「入力テキスト領域」、「リッチ・テキスト領域」、「入力 - パスワード」、および「入力 - 非表示」があります。

「入力」コンポーネントをご使用のページに追加するには、次のようにします。
  1. 「入力」コンポーネントをパレットからページにドラッグする。 「プロパティー」ビューに、「入力」コンポーネントのプロパティーが表示されます。
  2. 「入力」コンポーネント (inputText) の「プロパティー」ビューで、次のプロパティーを設定することができます。「値」フィールドのレコードにコンポーネントをバインドすることもできます。コントロールをバインドするには、「プロパティー」ビューの「基本」タブの「値」フィールドの横にある「バインド先」ボタンをクリックするか、プロパティーを「ページ・データ」ビューからコントロールに直接ドロップすることができます。データ・ソースがすでに定義されている場合のみ、これらの 2 つの方法が機能します。
    • 入力コンポーネントに自動的に生成された ID を変更する (オプション)。
    • スタイル・プロパティー (フォント、フォント・サイズ、レイアウト、色) およびスタイル・クラス (スタイル・シート) を設定する。
    • 「値」フィールドで、コンポーネントをレコードとバインドする。コンポーネントをバインドするには、「値」フィールドの横にある「バインド先」ボタンをクリックするか、プロパティーを「ページ・データ」ビューからコンポーネントに直接ドラッグすることができます。データ・ソースがすでに定義されている場合のみ、これらの 2 つの方法が機能します。
  3. リストからフォーマットを選択する。
    フォーマット 説明
    ストリング これはデフォルト・フォーマットです。ユーザーは英数字テキスト・ストリングを入力することができます。
    数値 ユーザーは、数値を入力できます。数値を選択すると、パネルに次の数値プロパティーを設定することができます。
    • タイプ: 10 進数、通貨、パーセント、またはカスタムを選択します。カスタムを選択すると、数値スタイルをカスタマイズできます。例えば、0.00% では、パーセント単位の 10 進数を使用することができます。
    • 入力支援 - ヘルパー・ボタンの表示: スピナーやスライダーを追加して、ユーザーが数値を選択しやすくするには、「ヘルパー・ボタンの表示」にチェック・マークを付けます。スピナーによって、値を増減できる矢印を使用して、値を選択することができます。スライダーによって、範囲内の値を入力できます。どちらのヘルパーでも、増加を指定することも可能です。例えば、増加に 10 を入力すると、スライダーやスピナーは数値を 10 だけ増加します。このオプションは、大きな数値を扱う場合に有効です。スピナーおよびスライダーの両方に、上限および下限を指定することもできます。
    • プロンプト文字の表示: ブラウザーで入力数値の自動編集を可能にします。例えば、ユーザーが 1234567 のような数値を入力すると、コンマが該当する場所に自動的に挿入されます (例: 1,234,567)。幾つかのプロンプト文字から選択することが可能です。また、このプロパティーをチェックすることで、サーバーで実行中にプロンプト文字を表示することができます。

      自動編集は、パーセント数値およびカスタム形式の場合は機能しません。

    日付/時刻 ユーザーは、日付、時刻、または両方を入力することができます。日付/時刻を選択すると、次の属性を設定することができます。
    • 型: 日付のみ、時刻のみ、または両方をリストから選択します。
    • 日付スタイル: 日付のスタイルを設定します。例: Apr 2, 2004。カスタムを選択すると、「パターン」フィールドで、カスタム日付スタイル・パターンを設定することができます。
    • 時刻スタイル: 時刻のスタイルを設定します。例: 11:29:48 PM。カスタムを選択すると、「パターン」フィールドで、カスタム時刻スタイル・パターンを設定することができます。
    • 入力支援: 「ヘルパー・ボタンの表示」にチェック・マークを付けて、ユーザーのカレンダー・ヘルパー (日付を選択の場合)、またはクロック・ヘルパー (時刻を選択の場合) を追加します。クロック・ヘルパーを追加すると、増加を設定することも可能です。
    • プロンプト文字の表示: ブラウザーで入力日付の自動編集を可能にします。例えば、入力日付は、"__/__/____" として表示できます。下線文字 ( _ ) は、ユーザーが日付を入力するときに置換されます。
    • プロンプト文字: デフォルトの下線文字 ( _ ) をここで指定する文字に置換します。
    マスク マスクをセットアップして、ユーザーが入力する英数字入力にフィルターをかけます。マスクを選択すると、次の属性を設定することができます。
    • マスク: 事前定義のマスクを選択するか、自分のマスクを入力します。ポンド記号 (#) は数値を表し、疑問符文字 (?) は文字を表します。マスクによって、ユーザーは電話番号やバッジ番号 (文字と数値の混合が可能) などのデータの入力が容易になります。
    • 入力支援 - プロンプト文字の表示: ブラウザーで入力データの自動編集を可能にします。例えば、マスク "###-##-####" を指定すると、入力フィールドは "___-__-____" として表示されます。下線文字 ( _ ) は、ユーザーが数値を入力するときに置換されます。
  4. 「検証」 タブ (inputText の下) で、ユーザー入力が送信されたときに、サーバーで検証を設定できます。 「値を必須にする」にチェック・マークを付けることによって、ユーザーにデータを入力するよう要求できます。最小値および最大値を設定することができます。ストリングでは、英字ストリングのみまたは数値ストリングのみが許可されるように制約を設定することができます。「エラー・メッセージ・コントロールで検証エラー・メッセージを表示 (Display validation error messages in an error message control)」にチェック・マークを付けて、入力コンポーネントで妥当性検査が失敗した場合に、エラー・メッセージを表示する「入力コンポーネント・エラーの表示」コンポーネントを自動的に作成します。「クリックしてカスタム検証コードを作成/編集」をクリックして、クイック編集ビューに切り替え、カスタム・コードを作成します。
  5. 「振る舞い」タブ (inputText の下) で、クライアントの「入力」コンポーネントの振る舞いおよび検証を設定します。ユーザーのコンポーネントを使用不可にしたり、コンポーネントをユーザーに読み取り専用とすることができます。また、ユーザーが入力を終了すると次のコンポーネントに進んだり、コンポーネントがサーバーに送信されたときに、コンポーネントの最大長を設定することができます。また、クライアントの検証を使用可能にしたり、検証が成功または失敗した場合のアクションを選択することもできます。例えば、ユーザーが成功すれば、入力フィールドを使用不可にすることができます。(「次のコントロールに自動的に進む」を「日付/時刻」コンポーネントで機能させたい場合、「検証」タブの「フィールドにプロトタイプのマスクを表示」も選択する必要があります。)
  6. 「アクセシビリティ」 タブ (inputText の下) で、アクセス・キーとしてキーボード・キーを設定することができます (実行時にこのキーをクリックすると、コンポーネントがフォーカスを取得できます)。また、コンポーネントのタブ順序、およびタイトル (実行時にユーザーにヒントを与えることができる) を設定することができます。
  7. 「入力」コンポーネントをページに追加する以外に、次の入力コンポーネントをページにドラッグすることができます。
    コンポーネント 説明
    入力 - テキスト・エリア 複数行のテキスト入力フィールド。「プロパティー」パネルで、行数を設定することができます。その他のプロパティーの多くは、「入力」コンポーネントのプロパティーと類似しています。
    リッチ・テキスト領域 ユーザーがリッチ・テキスト文書を作成および編集できるようにするリッチ・テキスト・フィールドです。
    入力 - パスワード ユーザーがパスワードを入力するテキスト入力フィールドです。
    入力 - 非表示 非表示の入力フィールドです。「入力 - 非表示」コンポーネントは、ページ間またはページのコントロール間でデータを受け渡すために、開発者がよく使用します。
Faces Web アプリケーションのいくつかの制限を確認するには、 『制限: Faces JSP アプリケーション』を参照し てください。
関連概念
JavaServer Faces
関連タスク
Faces アプリケーションの作成 : 概要
Faces JSP の作成
Faces 入力コンポーネントへの検証の追加
入力フォームの作成
関連資料
入力
入力 - 非表示
入力 - パスワード
入力 - テキスト・エリア
Faces コンポーネント参照
Faces コンポーネントの属性
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005