フォーム項目タイプのリファレンス
Liferayフォームアプリケーションには、フォームに追加する多くの項目タイプと要素が含まれています。 利用可能な要素を見つけるには、
- 製品メニュー （
）を開き、サイト管理メニューのコンパスアイコン（
）をクリックします。 フォームを作成するサイトを選択します。 - コンテンツ & データ → フォーム をクリックします。
- 追加 ボタン (
) をクリックします。 フォームビルダービューが表示されます。 - 追加 ボタン () をもう一度クリックして、 要素の追加 サイドバーを表示します (まだ開いていない場合)。
フォームフィールドのグループ化と繰り返し: フォームフィールドは、フォーム全体で使用できるようにグループ化できます ( 要素セット を使用)。または、フォーム内でフィールドグループにすることもできます。 フィールドを他のフィールドの上にドロップして、フィールドグループを作成します。 さらに、各フィールドは設定で 繰り返し可能 とマークすることができ、これによりフォームのエンドユーザーはフォーム内のフィールドを複製できます。
フィールド設定の概要
フォームビルダーで新しいフィールドを追加したり、既存のフィールドをクリックすると、フィールド設定エディタのサイドバーが表示されます。 使用できる設定オプションは、項目タイプによって異なります。
すべてのフォームフィールドには、ベーシックとアドバンスの少なくとも2つの設定タイプがあります。 以下のような基本的な設定だけで、多くのフォームを作成することができます。
- ラベル
- プレースホルダーテキスト
- 必須（および必須メッセージの内容）
- ヘルプテキスト
さらにフィールド固有の基本設定もあります。
詳細設定は以下の通りです。
- 初期値
- 検索設定
- そのフィールドが繰り返し可能かどうか
- システム／プログラムフィールドリファレンス
- フィールド確認
- フィールドが非表示かどうか
さらにフィールド固有の詳細設定もあります。
非表示のフィールド
外部ソース ( REST データ プロバイダーなど) からの情報を、 フォーム ルール をトリガーするためだけに使うフォーム フィールドに渡すと便利な場合があります。 この場合、フィールドの非表示設定（Liferay 7.4の新機能）を使用します。
フィールド確認
フィールド確認は、バージョン7.4以降のLiferayフォームでサポートされています。 確認フィールドは、フォームビルダーでフォーム本体に直接追加するフィールドではなく、1行のテキストまたは数値フィールドを ［確認が必要］ に設定した場合にのみフォームに表示されます（フィールドの詳細設定セクションを使用）。 このフィールドでは、重要なデータを持つフィールドが正しく入力されるようにします（例えば、メールアドレスのフィールドなど）。
確認フィールドを有効にすると、新しい設定オプションが表示されます。
方向： 垂直（デフォルト）または水平を選択して、確認フィールドを元のフィールドの下に表示するか、横に表示するかを決定します。
ラベル: 元のフィールドラベルの接頭辞を選択します。 デフォルト値はConfirmなので、Email Addressというフィールドの確認フィールドのラベルは、 Confirm Email Addressとなります。
エラーメッセージ： 確認するフィールドに応じて、より具体的なエラーメッセージを提供することができます。
ユーザーが有効な形式で情報を入力していることを確認する方法については、 テキストおよび数値フィールド入力の検証 を参照してください。
フィールド名、フィールドID、およびフィールドの参照
Liferay 7.3の最初のリリースでは、編集可能な構成のフィールド名が削除され、読み取り専用のフィールド IDが各フィールドの［詳細設定］タブに含まれるようになりました。 しかし、Liferay 7.3では、編集可能な代替品であるフィールド参照が利用できるようになりました。 プログラムでフィールドを参照する場合は、7.2のフィールド名の値と7.3以降のフィールド参照を使用します。
フォームのフィールドと要素
パラグラフ
パラグラフフィールドは、フォーム作成者が入力した静的なテキストをフォーム上に表示します。 ユーザーは説明文フィールドにデータを入力しません。 これは、指示が長い場合に役立ちます。
説明文フィールドは単なるプレーンテキストではありません。 埋め込み式のコンテンツエディターを使って、リッチコンテンツを作成します。
テキスト項目
ユーザーはこれらのフィールドに自由形式のテキストを入力します。 たとえば、氏名フィールドはテキストフィールドです。 デフォルトでは、テキストフィールドはすべての入力を1行のテキストに保持します。 より長い応答に対応するには、この例のようにテキストフィールドを構成するときに複数行設定を選択します。 テキストフィールドのバリデーションオプションを使って、ユーザーが入力できるテキストに制限を設けることができます（例：1～10の数字、メールアドレスなど）。
プルダウン
ユーザーは、選択肢のリストから1つ（または許可されている場合は複数）のオプションを選択します。 選択肢は手動で入力されるか、 データプロバイダー によって自動的に入力されます。 たとえば、居住国フィールドは、Countries of the Worldデータプロバイダーによって入力されたリストフィールドから選択できます。
ラジオボタン
ユーザーは、ラジオボタンを使用して、フォームに表示されたオプションのリストから1つのオプションを選択します。
ブール値
ユーザーは、チェックボックスやスイッチを有効にしたり無効にしたりして、表示されたテキストに対する true または false の応答を記録します。
日付
ユーザーは日付ピッカーを使用して日付を選択します。
Liferay 7.4では、日付フィールドの詳細設定に入力値の検証が含まれています。 フィールドの詳細設定にある検証オプション を使用すると、ユーザーが入力できる日付に制限（例：1～10の数字、メールアドレスなど）を設定できます。
日時
Liferay 7.4で追加された、ユーザーが日付と時刻の両方を1つのフィールドに入力する機能です。
日時フィールドは、 DD/MM/YYYY HH:MM [AM/PM]のフォーマットで入力します。 例えば、 01/06/1981 12:15 PM は1981年1月6日、午後12時15分です。 日時のピッカーを使用するか、ユーザーがフィールドに直接日付を入力することができます。
複数選択
ユーザーは、チェックボックス（または設定されている場合はトグル）から1つ以上のオプションを選択します。
グリッド
ユーザーは、ラジオボタンを使用して、行と列に配置されたオプションから選択します。 行ごとに1つの選択を行うことができます。 これは、複数の質問に同じ回答メトリックが必要な場合に役立ちます。
数値
ユーザーは数値データ（整数または小数）を数値フィールドに入力します。 数字以外の入力は受け付けません。
数値フィールドには、興味深い詳細なフィールド設定があります。
- 確認が必要 は、ユーザーがデータを正しく入力したことを確認します。
- 検証 は、ユーザー入力を事前に設定された要件に制限します。
- 入力マスク を使用すると、ユーザーが数値データを入力するときに正しい形式を表示できます。
アップロード
アップロードフィールドを使用すると、ユーザーはローカルファイルシステムからファイルをアップロードできます。 ログインしているユーザーは、以前にアップロードしたファイルから選択するか、新しいファイルをアップロードできます。
7.2でログインすると、ユーザーはドキュメントとメディアライブラリから既存のファイルを選択するか、ローカルファイルシステムからファイルをアップロードすることを選択できます。
Liferay 7.3 (DXP FP1およびCE GA7 )以降、認証されていないゲストユーザーにファイルのアップロードを許可することができます。 フォームフィールドの設定でゲストのアップロードを有効にします。
アップロードされたドキュメントは、 ドキュメントおよびメディアリポジトリ の隠しフォルダに保存されます。 Documents and Mediaアプリケーションに表示するには、portal-ext.propertiesファイルに以下のポータル・プロパティを設定します：
dl.show.hidden.mount.folders=true
コントロール パネルの「システム設定」→「フォーム (コンテンツ & データ)」→「フォーム」でゲストのアップロード動作を設定するか、 com.liferay.dynamic.data.mapping.form.web.internal.configuration.DDMFormWebConfiguration.config という名前の 構成ファイル を作成します。
ヒント
インスタンススコープでFormsアプリケーションを設定するには、インスタンス設定のFormsエントリを使用します。
ゲストがアップロード可能なファイル拡張子（guestUploadFileExtensions）： 許可済ファイル拡張子のコンマ区切りリストを入力します。 デフォルトでは、次のリストがサポートされています: doc、 docx、 jpeg、 jpg、 pdf、 png、 ppt、 pptx、 tiff、 txt、 xls、および xlsx。
ゲストがアップロード可能な最大ファイルサイズ（guestUploadMaximumFileSize）：ゲストユーザーがアップロードフィールドからアップロードできるファイルの最大サイズを設定します。 これは、ドキュメントとメディアアプリケーションの設定で、認証されたユーザーに対して設定され、システム全体の制限は、アップロードサーブレットリクエストシステム設定エントリーの［合計最大アップロードリクエストサイズ］というフィールドで定義されます。 デフォルトでは25MBに設定されています。
アップロードフィールドの最大繰り返し回数（maximumRepetitionsForUploadFields）：フィールドが繰り返し可能に設定されている場合、ユーザーがフィールドをフォームに追加できる最大回数を設定します (ゲスト ユーザーとログインしたユーザーに同じように適用されます)。 デフォルトでは5に設定されています。
ゲストアップロードフィールドの最大送信数（maximumSubmissionsForGuestUploadFields）：ゲストが使用可能なアップロードフィールドを含むフォームをゲストユーザーが送信できる最大回数を設定します。 ゲストユーザーのIPアドレスは、送信数の記録のために使用されます。 デフォルトでは5に設定されています。
画像
ユーザーは、［Web Content Images］、［Documents and Media］ライブラリから画像ファイル（.gif、.jpeg、.jpg、.png）を選択したり、ローカルファイルシステムから画像ファイルをアップロードしたりすることができます。
重要
ゲストユーザーは、画像へのアクセスやアップロードができません。 認証されたユーザーのみがフォームにアクセスできる場合を除き、このフィールドは使用しないでください。
画像を追加した後、ユーザーは画像の追加フィールドである 説明を記入することができます。 画像フィールドがオプションの場合、使い方は簡単で、画像もその説明も必要ありません。 ただし、他のフォームフィールドと同様に、画像フィールドは必須とマークすることができます。 画像フィールドが必須である場合、フォームビルダーは説明を必須とするか任意とするかを選択することができます。
色
ユーザーは、カラーピッカーから色を選択するか、コードを直接入力することで、色の16進コードを入力することができます。
リッチテキスト
ユーザーは、リッチテキストコンテンツ（フォーマットされたテキスト、埋め込まれた画像、添付ファイルなど）をフォームフィールドに入力することができます。
位置を検索
Liferay 7.4以降の［ロケーションの検索］フィールドを使用して、フォームユーザーから有効なアドレスを簡単に収集します。
詳細については、 検索場所フィールドの使用 を参照してください。
関連トピック