> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ドロップダウン選択

> DingTalk YiDAのドロップダウン選択コンポーネントの使い方を解説します。デフォルト値の設定方法、オプション値と表示値の違い、関連フォームコンポーネントとの使い分け、データ連動やデータソース連携まで、フォーム設計に必要な知識を紹介します。

## 1. 利用シーン

複数のドロップダウンオプションから 1 つの項目を選択します。このコンポーネントは、選択肢が多い場合に適しています。オプションのコンテンツをカスタマイズでき、[**データ連動**](/ja/yida/form/arpur0) や [**他フォームとの関連付け**](/ja/yida/form/tg64d5) などのシナリオにも対応します。たとえば、休暇申請フォームの休暇種別や性別などのフィールドで、ドロップダウン選択コンポーネントを使用します。

オプションを他のフォームから取得し、選択後に関連情報をフォームへ自動入力する必要がある場合（データ関連シナリオ）、たとえば契約管理シナリオで契約や注文を作成し、関連フォームコンポーネントのオプションを顧客テーブルと連動させて顧客情報を取り込む場合には、代わりに [**関連フォーム**](/ja/yida/form/agd540) コンポーネントを使用してください。

**注意：ドロップダウン選択コンポーネントのオプション値の最大長は 255 文字です。**

<Note>
  コンポーネントの属性、使い方、例については、[**こちら**](/ja/open/yida/components/interface)をご参照ください。
</Note>

## 2. 基本機能

### 2.1 クリアボタン

オプションボックス内のコンテンツをクリアします。

コンポーネントのクリアボタン。

**結果：**

### 2.2 検索対応

オプションを検索できます。ドロップダウンオプションが多い場合、検索機能で目的のコンテンツをすばやく見つけられます。

コンポーネントコンテンツの検索対応。

**結果：**

### 2.3 データがない場合に表示するコンテンツ

検索オプションがオンの場合、送信ページで検索できます。一致するデータが見つからないときに表示するメッセージを設定できます。

データがない場合に表示するコンテンツ。

**結果：**

### 2.4 オプションタイプ

ここでドロップダウンオプションのコンテンツを設定します。オプションはカスタマイズすることも、他のフォームのデータと関連付けることもできます。

利用可能なタイプ：

オプションタイプ — 他フォームのデータとの関連付けを設定。

#### 2.4.1 カスタム

オプションタイプがカスタムの場合、下部にオプションを追加してドロップダウンのコンテンツを自分で編集します。[**オプション連動設定**](/ja/yida/form/pw4kp6) を設定することもできます。

カスタムデータ型 — オプション 1、オプション 2 など。

#### 2.4.2 データソースの検索

外部データソースをデータソースとして検索する必要がある場合（外部システムとの連携でよく利用されます）、以下の設定を参照してください。

**設定パス：**

**API 形式：**

###### リクエストパラメータ

* q：ユーザーが検索するコンテンツ。検索ボックスがリクエストを送信する際、デフォルトで下図のパラメータが含まれます。

###### レスポンス

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "success": true,
  "content": [
    {
      "text": "オプション A",
      "value": "A"
    },{
      "text": "オプション B",
      "value": "B"
    },{
      "text": "オプション C",
      "value": "C"
    },
  ],
  "errorCode": "",
	"errorExtInfo": null,
	"errorLevel": "",
	"errorMsg": ""
}
```

## 3. FAQ

### 3.1 ドロップダウン選択のデフォルト値を設定する方法

該当するオプションを選択します。選択されたオプションは、下図のように青いリングで表示されます。

ドロップダウン選択コンポーネントのデフォルト値を設定。

**結果：**

### 3.2 オプション値と表示値は異なっていてもよい

オプション値と表示値は異なっていてもよく、多言語対応や表示値の変更など、さまざまなシナリオで柔軟に活用できます。

オプション値と表示値。

### 3.3 ドロップダウン選択と関連フォームコンポーネントの違い

両コンポーネントは、機能の定義と利用シーンが異なります。

#### 3.3.1 ドロップダウン選択

**オプションソース**：カスタムオプション、他のフォームからの取得、リモートデータソースからの取得、またはデータ連動による取得。

**利用シーン**：通常、追加データを取り込む必要のない選択シナリオで使用します。たとえば、休暇申請フォームの休暇種別や性別などのフィールドで、ドロップダウン選択コンポーネントを使用します。

#### 3.3.2 関連フォーム

**オプションソース**：他のフォームから取得。

**利用シーン**：通常、データ関連シナリオで使用します。たとえば、契約管理シナリオで契約や注文を作成する際に、関連フォームコンポーネントのオプションを顧客テーブルと関連付けて顧客情報を取り込みます。

<AccordionGroup>
  <Accordion id="q1" title="3.4 YiDA のドロップダウン選択コンポーネントは、一括編集やコンポーネントタイプの変換に対応していますか？">
    コンポーネントタイプの変換には現在対応していません。一括編集には対応しています。
  </Accordion>

  <Accordion id="q2" title="3.5 ドロップダウン選択の値を一行テキストコンポーネントに代入する方法は？">
    一行テキストコンポーネントで数式を設定し、下図のようにドロップダウン選択コンポーネントを直接選択します。
  </Accordion>
</AccordionGroup>