入力 - 非表示

隠しフィールドをページに作成します。隠しフィールドは、データを含めることができますが、ユーザーからは見えません。 これは多くの場合、ページ間で情報を受け渡したり、システム情報を保持したりするために使用されます。

設計時のコンポーネント

入力 - 非表示」コンポーネントをページにドラッグ・アンド・ドロップします:
「入力 - 非表示」コンポーネント・ボタン

入力 - 非表示」コンポーネントは、 ページでこのように表示されます:
設計時の「入力 - 非表示」

実行時のコンポーネント

入力 - 非表示」コンポーネントの実行時のビジュアル・レンダリングはありません。

「プロパティー」および「すべての属性」ビュー

コンポーネントの「プロパティー」ビューには、コンポーネント上で設定できる最も一般的な属性セットが表示されます。コンポーネントによっては、コントロール、アクション、または他のコンポーネントを追加するためのオプションが表示されることもあります。「プロパティー」ビューを開くには、「ウィンドウ」 > 「ビューの表示」 > 「プロパティー」をクリックします。ただし、このビューはデフォルトで開かれています。

「入力 - 非表示」コンポーネントのこれらの共通属性は、「プロパティー」ビューの「h:inputHidden」タブおよび「妥当性検査 (Validation)」タブに表示されます。属性の詳細なリストについては、『入力 - 非表示の全属性』の表を参照してください。入力の妥当性を検査するその他の構成オプションは、「h:inputHidden」 > 「妥当性検査 (Validation)」タブにあります。

表 1. 入力 - 非表示の構成オプション

構成オプション

説明

クリックしてカスタム検証コードを作成/編集

「クイック編集」ビューに切り替えて、 さまざまなユーザー開始イベントに対応するスクリプトまたはコードの断片を入力できるようにします。

制約

コンポーネントに入力できる文字のタイプを制限します (例えば、 数値のみ、ASCII 英字のみなど)。「すべての属性」ビューに regex 属性を指定した hx:validateConstraint を追加します。

エラー・メッセージ・コントロールに検証エラー・メッセージを表示

選択されたコンポーネントに関連付けされたエラー・メッセージ・コントロール・コンポーネントを挿入します。これにより、妥当性検査が失敗した場合にエラー・メッセージが表示されるようになります。

最大長

サーバーでサブミットするときにこのコンポーネントに含めることのできる最大文字数。 「すべての属性」ビューに maximum 属性を指定した関数 f:validateLength を追加します。

最小長

サーバーでサブミットするときにこのコンポーネントに含めることのできる最小文字数。 「すべての属性」ビューに minimum 属性を指定した関数 f:validateLength を追加します。

「すべての属性」ビューには、コンポーネント上で設定できるすべての属性のテーブルが表示されます。これには、「プロパティー」ビューからアクセスできる属性も含まれます。「すべての属性」ビューに切り替えるには、「プロパティー」ビューの右上で「すべての属性」アイコンすべての属性アイコンをクリックしてください。

表 2. 入力 - 非表示の全属性

属性名

「プロパティー」ビューでの再表示

説明

binding

再表示しない

通常はバッキング・ファイルの中でこのコンポーネントを表す UIComponent。

converter

再表示しない

値を変換するためのデータ型を指定します。JavaServer Faces 実装により、 コンポーネント・データをそのレンダラーがサポートしない型に変換するために使用できる一連の Converter 実装が行われます。

id

ID

名前をコンポーネントに割り当てます。JSP 内の固有名でなければなりません。

immediate

再表示しない

この値が true の場合は、ライフ・サイクルのレンダリング・フェーズに直接スキップしてください。

rendered

再表示しない

true または false に設定できます。
  • false - コンポーネントは実行時にブラウザーへのレンダリングが行われません。
  • true - コンポーネントのレンダリングが行われます。

required

検証 > 値を必須にする

このコンポーネントを指定する必要があります。これにチェック・マークを付けると、ユーザーが値を入力することが必要になります。

validator

再表示しない

インスタンス化する、バリデーターのクラス名。

value

実行時に表示されるコンポーネントの初期テキスト値を指定します。表示される情報が、指定された値の形式で、または動的値へのポインターの形式で組み込まれます。

valueChangeListener

再表示しない

コンポーネントの値の変更時に通知されるメソッド。

関連概念
JavaServer Faces を使用したデータ・アクセス Web アプリケーションの作成
関連タスク
Faces アプリケーションの作成 - 概要
関連資料
Faces コンポーネントの参照
Faces コンポーネントの属性
入力
入力 - パスワード
入力 - テキスト・エリア
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.