--- title: "リスト要素" slug: "the-list-elements" abstract: "ドロップダウンリスト、リストボックス、チェックボックス、ラジオボタンリストにはデフォルトのリスト要素を使いましょう。" --- # リスト要素 多くのフォームはリストを使ってデータを集めます。フォームアプリケーションには、ドロップダウンリスト、リストボックス、チェックボックス、ラジオボタンリストのデフォルトリスト要素が含まれています。リストアイテムは [既存データに接続](https://doc.sitecore.com/xp/ja/users/91/sitecore-experience-platform/add-list-items-for-forms.html "Add list items for forms")することも、項目作成時に入力する固定値を表示することもできます。 [フォームに新しいリスト要素を追加する](https://doc.sitecore.com/xp/ja/users/91/sitecore-experience-platform/add-list-items-for-forms.html "Add list items for forms")と、デフォルトの動作はアイテムの値がラベルと同じになります。値フィールドで**「カスタマイズ**済み」を選択すると、ラベルとは異なるカスタム値を入力できます。この場合、ラベルと値の両方を指定してください。そうしないと、顧客がリストからオプションを選択したときにその値がデータベースに保存されません。 このトピックでは、リスト要素とその設定について説明します。 ## ドロップダウンリスト ドロップダウンリスト要素を使って、連絡先が選択できる選択肢のリストを表示します。 セクション アイテム 概要 詳細 レーベル 特定のフォーム欄が求めている情報を示すキャプション。 フィールド名 要素名。フィールド名には必ず意味のある名前を使わせてください。フィールド名はフォームフィールドのSitecore定義アイテムの実際のアイテム名です。 リスト項目 静的か動的か リスト項目が既存データに接続されるか固定値に接続するかを決定します。 データソースを選択してください 「Browse(...)」をクリックしてデータソースを選択してください。 **コントロールダイアログボックスの「データソースの選択** 」で、表示したいフィールド値に対応するサブアイテムを含むウェブサイトのアイテムに移動します。関連するアイテムを選択し、「 **Select**」をクリックします。 ドロップリスト アイテム1ラベル 最初のドロップリスト項目を指定します。 ドロップリスト項目の値 データベースに保存される値を決定します。オプションは **ラベルと同じ** かカスタマイズ **されています**。 価値 **Dropリストボックスのアイテム値**フィールドで**「カスタマイズ**済み」を選択したときに、データベースに保存されたいリストボックスの値を設定します。 デフォルト選択リスト項目 デフォルトで事前選択されているリスト項目。 リストの上部にある空のリスト項目 リストが空行で始まるかどうかを示します。選択肢は **「はい** 」か「 **いいえ**」です。 検証 フィールドの重要性 訪問者が項目を記入しなければならないかどうかを示します。オプションは **任意** または **必須**です。 スタイリング CSSクラス フィールドのCSSクラスを定義します。 ラベル用のCSSクラス ラベルのCSSクラスを定義します。 詳細設定 セーブを許可します フォーム提出時に入力済みフィールドデータの保存を有効または無効にします。 ## リストボックス リストボックス要素を使って、連絡先がゼロ、1、または複数を含む任意の数の選択肢を選べる選択肢のリストを表示します。 セクション アイテム 概要 詳細 レーベル 特定のフォーム欄が求めている情報を示すキャプション。 フィールド名 元素の名前。 リスト項目 静的か動的か リスト項目が既存データに接続されるか固定値に接続するかを決定します。 データソースを選択してください 「Browse(...)」をクリックしてデータソースを選択してください。 **コントロールダイアログボックスの「データソースの選択** 」で、表示したいフィールド値に対応するサブアイテムを含むウェブサイトのアイテムに移動します。関連するアイテムを選択し、「 **Select**」をクリックします。 リストボックス項目 アイテム1ラベル 最初のリストボックス項目の価値です。 リストボックスの項目値 データベースに保存される値を決定します。オプションは **「ラベルと同じ** 」または **「カスタマイズ」**です。例えば、フォームの異なる言語バージョンを使う場合、元の言語値をデータベースに保存することができます。 価値 **リストボックスの項目価値**フィールドで**「カスタマイズ**済み」を選択したときに、データベースに保存されたいリストボックスの値を設定します。 デフォルト選択リスト項目 デフォルトで事前選択されているリスト項目。 選択モード リストから一度に1つの項目しか選択できないか、複数項目を選べるかを示します。オプションは **単一** か **複数**です。 列 列数。 検証 フィールドの重要性 連絡先が欄を埋める必要があるかどうかを示します。オプションは **任意** または **必須**です。 スタイリング CSSクラス フィールドのCSSクラスを定義します。 ラベル用のCSSクラス ラベルのCSSクラスを定義します。 詳細設定 セーブを許可します フォーム提出時に入力済みフィールドデータの保存を有効または無効にします。 ## チェックボックスリスト チェックボックスリスト要素を使って、連絡先が0、1、または複数を含む任意の数の選択肢を選択できるオプションのリストを表示します。 セクション アイテム 概要 詳細 レーベル 特定のフォーム欄が求めている情報を示すキャプション。 フィールド名 元素の名前。 リスト項目 静的か動的か リスト項目が既存データに接続されるか固定値に接続するかを決定します。 データソースを選択してください 「Browse(...)」をクリックしてデータソースを選択してください。 **コントロールダイアログボックスの「データソースの選択** 」で、表示したいフィールド値に対応するサブアイテムを含むウェブサイトのアイテムに移動します。関連するアイテムを選択し、「 **Select**」をクリックします。 チェックボックス1ラベル 最初のチェックボックス項目の価値です。 チェックボックスの値 データベースに保存される値を決定します。オプションは **「ラベルと同じ** 」または **「カスタマイズ」**です。例えば、フォームの異なる言語バージョンを使う場合、元の言語値をデータベースに保存することができます。 価値 **チェックボックス**値フィールドで**「カスタマイズ**済み」を選択したときにデータベースに保存したいリストボックスの値を設定します。 選択されたチェックボックス デフォルトで事前選択されているリスト項目。 検証 フィールドの重要性 連絡先が欄を埋める必要があるかどうかを示します。オプションは **任意** または **必須**です。 スタイリング CSSクラス フィールドのCSSクラスを定義します。 ラベル用のCSSクラス ラベルのCSSクラスを定義します。 詳細設定 セーブを許可します フォーム提出時に入力済みフィールドデータの保存を有効または無効にします。 ## ラジオボタン一覧 Radioボタンのリスト要素を使って、フォームに2つ以上の選択肢のリストが表示されるフィールドを追加し、ユーザーが1つの選択肢を選択する必要があります。 セクション アイテム 概要 詳細 レーベル 特定のフォーム欄が求めている情報を示すキャプション。 フィールド名 元素の名前。 リスト項目 静的か動的か リスト項目が既存データに接続されるか固定値に接続するかを決定します。 データソースを選択してください 「Browse(...)」をクリックしてデータソースを選択してください。 **コントロールダイアログボックスの「データソースの選択** 」で、表示したいフィールド値に対応するサブアイテムを含むウェブサイトのアイテムに移動します。関連するアイテムを選択し、「 **Select**」をクリックします。 ラジオボタン1のラベル 最初のリスト項目の価値です。 ラジオボタンの値 データベースに保存される値を決定します。オプションは**ラベルと同じ****かカスタマイズ**されています。 選択済みのラジオボタン デフォルトで事前選択されているリスト項目。 検証 フィールドの重要性 連絡先が該当する欄を記入しなければならないかどうかを示します。オプションは **任意** または **必須**です。 スタイリング CSSクラス フィールドのCSSクラスを定義します。 ラベル用のCSSクラス ラベルのCSSクラスを定義します。 詳細設定 セーブを許可します フォーム提出時に入力済みフィールドデータの保存を有効または無効にします。