これにより、ストリング、数値、日付/時刻およびマスクのデータ・タイプの入力フィールドを作成することができます。「入力」コンポーネントをページに追加する場合は、「入力」コンポーネントの「プロパティー」ビューで、いずれかのフォーマットを選択してください。
「入力」コンポーネントをページにドラッグ・アンド・ドロップします:
「入力」コンポーネントは、
設計時にページでこのように表示されます:
「入力」コンポーネントは、
実行時にページでこのように表示されます:
コンポーネントの「プロパティー」ビューには、コンポーネント上で設定できる最も一般的な属性セットが表示されます。コンポーネントによっては、コントロール、アクション、または他のコンポーネントを追加するためのオプションが表示されることもあります。「プロパティー」ビューを開くには、「ウィンドウ」 > 「ビューの表示」 > 「プロパティー」をクリックします。ただし、このビューはデフォルトで開かれています。
「入力」コンポーネントのこれらの共通属性は、「プロパティー」ビューの「h:inputText」タブ、「妥当性検査 (Validation)」タブ、「振る舞い」タブ、および「アクセシビリティ (Accessibility)」タブに表示されます。属性の詳細なリストについては、『入力の全属性』の表を参照してください。入力の妥当性を検査したり、振る舞いを変更したり、入力フォーマット・タイプを構成するその他の構成オプションは、「h:inputText」 > 「妥当性検査 (Validation)」タブ、「h:inputText」 > 「振る舞い」タブ、「h:inputText」タブにあります。
構成オプション |
説明 |
---|---|
次のフィールドに自動的に進む |
自動タブを使用可能にするかどうかを指定します。指定された数の文字が入力された後で、別の入力フィールドに自動的に進みます。これにチェックマークを付けると、「すべての属性」ビューに hx:inputHelperAssist セクションが追加され、autoTab が True に設定されます。 |
クリックしてカスタム検証コードを作成/編集 |
「クイック編集」ビューに切り替えて、 さまざまなユーザー開始イベントに対応するスクリプトまたはコードの断片を入力できるようにします。 |
制約 |
コンポーネントに入力できる文字のタイプを制限します (例えば、 数値のみ、ASCII 英字のみなど)。「すべての属性」ビューに regex 属性を指定した hx:validateConstraint を追加します。 |
エラー・メッセージ・コントロールに検証エラー・メッセージを表示 |
選択されたコンポーネントに関連付けされたエラー・メッセージ・コントロール・コンポーネントを挿入します。これにより、妥当性検査が失敗した場合にエラー・メッセージが表示されるようになります。 |
フォーマット |
コンポーネントによって操作されるデータのフォーマットを指定します。
|
最大長 |
サーバーでサブミットするときにこのコンポーネントに含めることのできる最大文字数。 「すべての属性」ビューに maximum 属性を指定した関数 f:validateLength を追加します。 |
最小長 |
サーバーでサブミットするときにこのコンポーネントに含めることのできる最小文字数。 「すべての属性」ビューに minimum 属性を指定した関数 f:validateLength を追加します。 |
ブラウザーでフィールド値を検証 |
実行時にブラウザーでフィールド妥当性検査を実行できます。 |
フォーマット・タイプ |
フォーマット・オプション |
---|---|
String |
「h:inputText」タブ
「妥当性検査」タブ
「振る舞い」タブ
|
Number |
「h:inputText」タブ
Validation tab:
「振る舞い」タブ
|
Date/Time |
「h:inputText」タブ
「妥当性検査 (Validation)」タブ
「振る舞い」タブ
|
Mask |
「h:inputText」タブ
「妥当性検査 (Validation)」タブ
「振る舞い」タブ
|
「すべての属性」ビューには、コンポーネント上で設定できるすべての属性のテーブルが表示されます。これには、「プロパティー」ビューからアクセスできる属性も含まれます。「すべての属性」ビューに切り替えるには、「プロパティー」ビューの右上で「すべての属性」アイコンをクリックしてください。
属性名 |
「プロパティー」ビューでの再表示 |
説明 |
---|---|---|
accesskey |
アクセシビリティ > アクセス・キー |
単一のキーボード・キーをアクセス・キーとして指定します。指定されたアクセス・キーを実行時に押すと、このコンポーネントにフォーカスが当てられます。 |
alt |
再表示しない |
コンポーネントの代替テキストを指定します。これは、フォームをサポートしないブラウザーやイメージを表示しないように設定されているブラウザーなどで通常、 エレメントを実行できないときに表示されます。 |
binding |
再表示しない |
通常はバッキング・ファイルの中でこのコンポーネントを表す UIComponent。 |
converter |
再表示しない |
値を変換するためのデータ型を指定します。JavaServer Faces 実装により、 コンポーネント・データをそのレンダラーがサポートしない型に変換するために使用できる一連の Converter 実装が行われます。 |
dir |
再表示しない |
実行時のコンポーネントの表示方向を指定します。指定できる値は次のいずれかです。
|
disabled |
振る舞い > コントロールを使用不可にする |
disabled が true に設定されている場合は、コンポーネントは実行時に表示されますが、 機能しません。ブランクのままにされた場合のデフォルト値は false です。 |
id |
ID |
名前をコンポーネントに割り当てます。JSP 内の固有名でなければなりません。 |
immediate |
再表示しない |
この値が true の場合は、ライフ・サイクルのレンダリング・フェーズに直接スキップしてください。 |
lang |
再表示しない |
コンポーネントの属性値およびテキスト内容の基本言語を指定します。 ISO 標準言語の省略形コード (たとえば、英語の場合は「en」、米国英語の場合は「en-US」、フランス語の場合は「fr」、ドイツ語の場合は「de」) を使用します。 |
maxlength |
振る舞い > ユーザーが X 文字を入力した後 |
エンド・ユーザーがコンポーネントにこの数の文字を入力した後で、制御属性を成立させます。 |
readonly |
振る舞い > コントロールを読み取り専用にする |
コンポーネントの値をその初期値から変更できないことを指定します。 |
rendered |
再表示しない |
true または false に設定できます。
|
required |
検証 > 値を必須にする |
このコンポーネントを指定する必要があります。これにチェック・マークを付けると、ユーザーが値を入力することが必要になります。 |
size |
サイズ: 幅 |
コンポーネントの初期幅を指定します。ここで指定する値は、文字数を表します。 |
style |
スタイル: プロパティー |
コンポーネントの CSS スタイル情報 (たとえば、style="font-size : 8pt ; color : red") を指定します。選択されたコンポーネントのプロパティー (フォントや色など) を定義します。これは、手動で行うことも、ボタンをクリックして希望するプロパティーをウィンドウ内で選択して行うこともできます。 |
styleClass |
スタイル: クラス |
このエレメントのレンダリング時に適用される CSS スタイル・クラスのスペースで区切られたリスト。この値は、生成されたマークアップ上の「class」属性としてパススルーする必要があります。選択されたコンポーネントのクラス (スタイル・シートなど) を定義します。これは、手動で行うことも、ボタンをクリックして希望するクラスをウィンドウ内で選択して行うこともできます。 |
tabindex |
アクセシビリティ > タブ順序インデックス |
JSP 内のタブ順序でのコンポーネントの位置を指定します。この値は 0 から 32767 までの数値でなければなりません。 |
title |
アクセシビリティ > タイトル |
実行時にツールチップとしてブラウザーに表示されるタイトル・テキストを指定します。 |
validator |
再表示しない |
インスタンス化する、バリデーターのクラス名。 |
value |
値 |
実行時に表示されるコンポーネントの初期テキスト値を指定します。表示される情報が、指定された値の形式で、または動的値へのポインターの形式で組み込まれます。 |
valueChangeListener |
再表示しない |
コンポーネントの値の変更時に通知されるメソッド。 |