フォーム

他のコンポーネントのメイン・コンテナーです。必要時には自動的に追加されます。

設計時のコンポーネント

「フォ ーム」コンポーネントを、 ページ上にドラッグ・アンド・ドロップします。

「フォーム」コンポーネントのボタン

「フォ ーム」コンポーネントは、ページ上でこのように表示されます。

デザイン時の「フォーム」

実行時のコンポーネント

「フォ ーム」コンポーネントには、 表示されるランタイム・レンダリングはありません。

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

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

「フォーム」コンポーネントの共通属性は、 「プロパティー」ビューの「h:form」タブ、 「キーボード補助機構」タブ、 および 隠しフィールド」タブに表示されます。 属性の完全なリストについては、「フォーム」のすべての属性 の 表を参照してください。 表示およびアクセシビリティーのための 追加構成オプションは、「h:form>キーボード補助機構」 および「h:form>隠しフィールド」タブにあります。

表 1. 「フォーム」構成オプション

構成オプション

説明

指定したキー・ストロークにアクションを割り当てます。

フォーム・コンポーネント内で、 キー・ストローク、アクション、それらのアクションのターゲットを指定します。 キー・ストロークおよびアクションは、ドロップダウン・リストから選択します。 ターゲットは、フォーム内に入力フィールド表示を 取り込んだドロップダウン・リストから選択します。 フォーム内でキーが押されると、アクションが実行されます。

隠しフィールド

フォーム内にある現在のすべての「入力 - 非表示」コンポーネントが表示され、 隠しフィールドの追加、除去、および変更を行うことができます。

このフィールドの内容を選択

フォーカスを持つように選択されたフィールドが、 その内容も最初に選択されるように指定します。

ページが初めて表示されたときにフォーカスを設定する (Set focus when the page is initially displayed)

ページが表示されたときに、最初にフォーカスされるフィールドを指定します。 「ページ内の最初のフィールド」また は「特定のフィールド」 (ID で識別) を指定することができます。

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

表 2. 「フォーム」のすべての属性

属性名

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

説明

accept

非表示

コンポーネントで許可されるファイルのタイプを、 コンマで区切って指定します。

acceptcharset

非表示

クライアントへの応答が予期される文字セット。 標準 HTML 属性。HTML フォーム・タグを参照してください。 この属性は、このフォームを処理するサーバーによって許可される、 入力データ用の文字エンコードのリストを指定します。 この値は、スペースまたはコンマ (あるいはその両方) で区切られた、 文字セット値のリストになります。 クライアントは、このリストを排他 OR リストとして解釈する必要があります。 つまりサーバーは、受け取ったエンティティーごとに、 任意の単一文字エンコードを受け入れることができます。

binding

非表示

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

dir

非表示

実行時にレンダリングされるときのコンポーネントの方向を指定します。 次のいずれかの値にできます。
  • ltr - 左から右
  • rtl - 右から左
方向を指定しない場合は、コンポーネントのエンコード方式に適している方向が使用されます。

enctype

非表示

フォームの送信に使用されるコンテンツ・タイプを指定します。

id

ID

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

lang

非表示

コンポーネントの値およびテキスト・コンテンツの言語。 省略されている場合、言語は含まれているタグ (特にビュー) から継承されます。これは、ISO 規格言語省略コードで指定します。例えば、英語は「en」、米国英語は「en-US」、 フランス語は「fr」、ドイツ語は「de」を使用します。
注: これは、コンポーネント内のテキストを変換するのではなく、検索、ソート、照合などの操作が正しく実行されるようにコンポーネントの言語を識別します。

rendered

非表示

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

style

スタイル: プロパティー

コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。

styleClass

スタイル: クラス

この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。

target

非表示

コンポーネントがクリックされたときにページがロードされる、 フレームセット内のターゲット・フレームを割り当てます。

title

非表示

実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。


フィードバック