ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

フォームフラグメントの作成

ライフレイ 7.4 U45+/GA45+

フォームコンポーネントフラグメントは、コンテンツページでオブジェクトのフォームを構築するためのものです。 Liferay のフォームフラグメントがユースケースを満たしていない場合は、独自のフォームフラグメントを作成して、フォームに必要なデザインと機能を実現します。

フォームフラグメントを作成するには、

サイトメニュー () を開き、 デザイン → フラグメントに移動します。
プラス () をクリックして、フォームフラグメントを整理するためのフラグメントセットを作成します。
追加 () をクリックし、 フォームフラグメント タイプを選択して、次へをクリックします。
名前を入力します。
フラグメントで許可するフィールドタイプを選択します。

CAPTCHA を選択した場合、他のフィールドタイプを選択することはできません。それ以外の場合は、任意のフィールドの組み合わせを選択できます。
追加をクリックします。これにより、ドラフトフラグメントが作成され、フラグメント編集ページが表示されます。
コードタブで、フラグメントの HTML、CSS、JavaScript を追加します。

注

マッピング設定を使用して、「送信」ボタンフラグメントのテキストをマッピングできます。

リダイレクト用のリンク設定を持つボタンを作成するには、ボタンフラグメントに type="button" を追加します。
(オプション) [構成] タブで、JSON を使用してフラグメントを構成し、オプションを追加します。さまざまなフラグメント構成タイプの詳細については、フラグメント構成タイプのリファレンスを参照してください。
公開をクリックします。

次に、フォームフラグメントを使用して、コンテンツページにフォームを構築します。詳細については、フラグメントを使用したフォームの構築を参照してください。

サポートされているフィールドタイプのリファレンス

項目タイプ	説明
`boolean`	ブールフィールド。
`captcha`	ユーザーは送信前に自分が人間であることを確認する必要があります。
`date`	日付フィールド。
`file`	ファイルの添付のサポートが追加されました。
`html`	リッチテキストを追加するための CKEditor を追加します。
`multiselect`	チェックボックスのリストから選択します。
`number`	数値フィールド。
`relationship`	オブジェクトの関係を定義します。
`select`	ドロップダウンリストからオプションを選択します。
`text`	テキストフィールドのサポートを追加します。

フォームフラグメントで `入力` 変数を使用する

フォームフラグメントには、各フラグメントの JavaScript および FreeMarker コードで使用するための 入力 変数が含まれています。この変数には、フラグメントを構成するためのプロパティが含まれています。

入力変数プロパティリファレンス

プロパティ	種類	説明
`fieldTypes`	`string`	入力にマップされたフィールドタイプ。
`name`	`string`	入力の名前。フラグメントを作成するには、ユーザーはこのプロパティを定義する必要があります。
`required`	`boolean`	入力が必須かどうか。
`value`	`string`	フィールドの値。
`label`	`string`	入力のラベル。
`showLabel`	`boolean`	ラベルの可視性。
`errorMessage`	`string`	フォーム送信エラー。
`helpText`	`string`	フォームフィールドの UI ヘルプメッセージ。定義されていない場合、このプロパティは空になります。
`showHelpText`	`boolean`	ヘルプテキストの表示。
`attributes`	`object`	特定の入力タイプのフラグメントに追加されたオプション。

`ファイル` 入力の属性

プロパティ	種類	説明
`allowedFileExtensions`	`string`	許可されるファイル拡張子。「サポートされているファイル情報の表示」が有効になっている場合、許可されている拡張子がフィールドのヘルプテキストに表示されます。
`maxFileSize`	`number`	最大アップロードサイズ（メガバイト単位）。「サポートされているファイル情報の表示」が有効になっている場合、フィールドのヘルプテキストに最大許容サイズが表示されます。
`selectFromDocumentLibrary`	`boolean`	ユーザーがドキュメントライブラリからファイルを選択できるかどうか。これはオブジェクトの添付フィールドに設定されます。
`selectFromDocumentLibraryURL`	`文字列` または `未定義`	`selectFromDocumentLibrary` が true の場合、このプロパティには、対応する `ItemSelector`をレンダリングするための URL が含まれます。

`数値` 入力の属性

プロパティ	種類	説明
`dataType`	`整数` または `小数`	整数または小数を選択します。
`max`	`数値` または `未定義`	許可される最大数。
`min`	`数値` または `未定義`	許可される最小数。
`step`	`文字列` または `未定義`	HTML 入力の「step」属性で使用して、許容される最大精度を示すことができる文字列値。

`関係` 入力の属性

プロパティ	種類	説明
`relationshipLabelFieldName`	`string`	ラベルとして使用される関連オブジェクトのフィールド名。
`relationshipValueFieldName`	`string`	値として使用される関連オブジェクトのフィールド名。
`relationshipURL`	`string`	API からオプションを取得するために使用される URL。 API 応答では、ページ区切りを含む Liferay のヘッドレスリスト形式が使用されます。応答を照会するには追加のパラメータを渡します。