入力 - 非表示

ページ上に隠しフィールドを作成します。 隠しフィールドにはデータを組み込むことができますが、 ユーザーには表示されません。 多くの場合、ページ間での情報の受け渡しや、システム情報の 保持に使用されます。

設計時のコンポーネント

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

「入力 - 非表示」コンポーネントのボタン

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

設計時の「入力 - 非表示」

実行時のコンポーネント

「入力 - 非表示」コンポーネントは、 実行時にビジュアル・レンダリングを持ちません。

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

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

「入力 - 非表示」コンポーネントの共通属性は、 「プロパティー」ビューの「h:inputHidden」タブ および「妥当性検査」タブに表示されます。 属性の完全なリストについては、「入力 - 非表示」のすべての属性 の 表を参照してください。 入力データを妥当性検査するための追加の構成オプションは、 「h:inputHidden」>「妥当性検査」タブにあります。

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

構成オプション

説明

カスタム検証コードを作成/編集するには、ここをクリック

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

入力制限 (Constraint)

コンポーネントに入力できる 文字のタイプを制限します (数字のみ、ASCII アルファベット のみ、など)。 regex 属性を持つ hx:validateConstraint を 「すべての属性」ビューに追加します。

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

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

最大長

サーバーで実行されるときに、このコンポーネントに 含むことができる最大文字数。maximum 属性を持つ f:validateLength 関数を、 「すべての属性」ビューに追加します。

最小長

サーバーで実行されるときに、このコンポーネントに 含むことができる最小文字数。minimum 属性を持つ f:validateLength 関数を、 「すべての属性」ビューに追加します。

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

表 2. 「入力 - 非表示」のすべての属性

属性名

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

説明

binding

非表示

コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。

converter

非表示

値の変換後のデータ型を指定します。 JavaServer Faces の実装によって、 コンポーネント・データをレンダラーがサポートしない型に変換する際に使用できる、 コンバーターの実装セットが提供されます。

id

ID

コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。

immediate

非表示

true にすると、ライフ・サイクルのレンダリング・フェーズまでスキップします。

rendered

非表示

true または false に設定できます。
  • false - コンポーネントは、実行時にブラウザーにレンダリングされません。
  • true - コンポーネントがレンダリングされます。これはデフォルト値です。

required

「妥当性検査」>「値を必須にする」

コンポーネントを指定する必要があります。 これをチェックして、ユーザーからの値の入力を要求します。

validator

非表示

FacesContext、UIComponent、およびオブジェクト・パラメーターを受け入れるメソッド (MethodBinding 式で表現されます)。検証プロセスで呼び出され、コンポーネントの値が正しいことを確認します。

value

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

valueChangeListener

非表示

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

関連タスク
入力フィールドのカスタム・パターンの定義
関連資料
データ・テーブル
入力
入力 - パスワード
入力 - テキスト領域
ファイル・アップロード
リッチ・テキスト領域

フィードバック