フォームフラグメントの使用
Liferay DXP 2023.Q3+/ポータル GA92+
Liferay には、コンテンツ ページにフォームを構築するためのフォーム フラグメントが含まれています。 フォームを作成するには、フォーム コンテナーをコンテンツ ページまたはページ テンプレートに追加し、公開されたオブジェクトにマップします。 コンテナーは、各オブジェクト フィールドにマップされたフラグメントを自動的に入力します。 フラグメントを手動で整理、削除、または追加できます。 公開されると、エンド ユーザーはフォームを使用してオブジェクト エントリを作成できます。
フォーム フラグメントをさまざまなセクションに追加し、ナビゲーション ボタンを使用してユーザーを各ステップに誘導することで、複数のステップを持つフォームを作成することもできます。 フラグメントを使用してマルチステップフォームを構築するを参照してください。
コンテンツページにフォームを構築するには、
- カスタム オブジェクトを作成します。
- コンテンツ ページにフォーム コンテナー フラグメントを追加します。
- フォーム コンテナー フラグメントをカスタム オブジェクトにマップします。
- フォーム フラグメントは、マップされたフォーム コンテナーにのみ配置します。
- データの損失を防ぐために、フォーム内のすべてのフォーム フラグメントをオブジェクト フィールドにマップします。
- すべての必須オブジェクト フィールドのフォーム コンテナーにフラグメントを含めます。
- 必須のフォームフラグメントを表示します。
- フォーム コンテナーに目に見える送信ボタンを含めます。
デフォルトでは、Liferay には フォーム コンポーネント フラグメント セットが含まれていますが、独自のフラグメント セットを作成することもできます。 詳細については、 フォームフラグメントの作成 を参照してください。
また、フォームフラグメントは カスタムオブジェクトでのみ使用できます。 したがって、Liferay では、公開されたオブジェクトが少なくとも 1 つ存在するまで、フォーム コンポーネント フラグメント セットが非表示になります。 公開されると、オブジェクトへのアクセス権を持つユーザーは、フォーム コンポーネント フラグメントを表示および使用できるようになります。
デフォルトのフォームフラグメント
Liferay は、 フォーム コンポーネント セットで次のフォーム フラグメントを提供します。 各フラグメントはオブジェクト フィールド タイプに対応しているか、フォームを構築するための追加機能を提供します。
| フォームフラグメント | 説明 |
|---|---|
| キャプチャ | 自動送信を防ぐための CAPTCHA チャレンジを追加します。 |
| カテゴリ | 利用可能な語彙を使用してエントリを分類するための UI。 |
| チェックボックス | ブール値のチェックボックスを 1 つ表示します。 |
| 日付 | 日付選択フィールドを提供します。 |
| 日時 | 日付と時刻を組み合わせたピッカー フィールドを提供します。 |
| Liferay DXP 2025.Q4 ドラッグアンドドロップアップロード | ドラッグ アンド ドロップでファイルをアップロードするための UI。 |
| ファイルアップロード | ローカル ファイルをアップロードするための UI。 |
| フォームボタン | フォームにカスタム ボタン要素を追加します。 |
| フォームコンテナー | すべてのフォーム フラグメントに必要なコンテナー。 オブジェクトにマップする必要があります。 |
| フォームリレーション | フォーム フィールドを関連するコンテンツ タイプにマップし、エントリ間の関係を作成します。 |
| Liferay DXP 2025.Q4 インラインテキスト | フォーム レイアウト内に編集可能なテキストを直接追加します。 |
| ローカライズ選択 | ローカライズされたフィールドの言語を選択するための UI。 |
| 複数選択 | 複数選択が有効になっているオプションのリストを表示します。 |
| 数値 | 整数または小数値の数値入力を提供します。 |
| リッチテキスト | リッチ テキスト エディター フィールドを表示します。 |
| 選択 | 単一の選択項目を含むドロップダウン リストを表示します。 |
| ステッパー | 複数ステップのフォームのナビゲーション ステップを表示します。 |
| タグ | オブジェクト エントリにタグを追加するための UI。 |
| テキストボックス | 1 行のテキスト入力を提供します。 |
| テキスト領域 | 複数行のテキスト入力を提供します。 |
| Liferay DXP 2025.Q4 URLビデオプレビューア | 指定された URL からのビデオのプレビューを表示します。 |
フォームコンポーネントでサポートされているフィールドタイプ
各フォーム フラグメントは、1 つ以上のオブジェクト フィールド タイプをサポートできます。 デフォルトのフォーム コンポーネントはこれらのフィールドをサポートします。
| フォームフラグメント | オブジェクト項目タイプ |
|---|---|
| キャプチャ | 該当なし |
| チェックボックス | ブール値 |
| 日付 | 日付 |
| ファイルアップロード | 添付ファイル |
| 複数選択リスト | 複数の選択リスト |
| 数値入力 | 整数、長整数、小数、精度小数 |
| リッチテキスト | リッチテキスト |
| プルダウン | 関係、選択リスト |
| 送信ボタン | 該当なし |
| テキスト入力 | テキスト、長いテキスト |
| テキストエリア | テキスト、長いテキスト |
オブジェクトの分類が有効になっている場合は、タグとカテゴリのフォームフラグメントを使用して、オブジェクトエントリにメタデータを追加できます。