下拉單選

1. 適用場景

從多個下拉選項(xiàng)中選擇其中一項(xiàng)，適用于選項(xiàng)較多的時候，可自定義選項(xiàng)內(nèi)容，也可用于 數(shù)據(jù)聯(lián)動 或 關(guān)聯(lián)其他表單 等多個場景，比如選擇請假表單內(nèi)的請假類型、性別等字段的時候，可以用下拉單選組件。

如果需要選項(xiàng)來源于其他表，且在選擇完選項(xiàng)后，將選項(xiàng)相關(guān)的信息填充至表單（數(shù)據(jù)關(guān)聯(lián)類的場景）比如合同管理場景中，在創(chuàng)建合同/訂單時，將關(guān)聯(lián)表單組件的選項(xiàng)與客戶表關(guān)聯(lián)，關(guān)聯(lián)出客戶信息等。建議使用 關(guān)聯(lián)表單 組件。

注意：下拉單選組件的選項(xiàng)值的長度最大不能超過 255 個字符

2. 基礎(chǔ)功能

2.1 清除按鈕

清除選項(xiàng)框內(nèi)的內(nèi)容

組件的清除按鈕

效果如下：

2.2 可搜索

允許對選項(xiàng)做搜索，當(dāng)下拉選項(xiàng)內(nèi)容過多時，可以通過搜索快速定位內(nèi)容。

可搜索組件內(nèi)容

效果如下：

2.3 無數(shù)據(jù)時顯示內(nèi)容

當(dāng)可搜索按鈕開啟的時候，提交頁面是支持搜索的，這個時候可以設(shè)置搜不到數(shù)據(jù)時的提示內(nèi)容。

無數(shù)據(jù)時顯示內(nèi)容

展示效果如圖：

2.4 選項(xiàng)類型

可以在這里設(shè)置下拉的選項(xiàng)內(nèi)容，可以自定義選項(xiàng)內(nèi)容也可以關(guān)聯(lián)其他表單數(shù)據(jù)。

具體類型如圖：

選項(xiàng)類型—配置關(guān)聯(lián)其他表單數(shù)據(jù)等

2.4.1 自定義

選項(xiàng)類型選擇自定義時，可以在下面添加選項(xiàng)，自行編輯下拉的選項(xiàng)內(nèi)容，還可以操作 關(guān)聯(lián)選項(xiàng)設(shè)置 等。

自定義數(shù)據(jù)類型—選項(xiàng)一、選項(xiàng)二等

2.4.2 搜索數(shù)據(jù)源

當(dāng)我們需要搜索外部數(shù)據(jù)源作為我們的數(shù)據(jù)來源，常見于和外部系統(tǒng)的聯(lián)動，可以參考如下配置：

設(shè)置路徑：

接口格式:

入?yún)?/h5>

• q : 用戶搜索內(nèi)容，搜索框發(fā)起請求的時候，會默認(rèn)帶上下圖的參數(shù)

返回值

{
  "success": true,
  "content": [
    {
      "text": "選項(xiàng)A",
      "value": "A"
    },{
      "text": "選項(xiàng)B",
      "value": "B"
    },{
      "text": "選項(xiàng)C",
      "value": "C"
    },
  ],
  "errorCode": "",
	"errorExtInfo": null,
	"errorLevel": "",
	"errorMsg": ""
}

3. 常用問題

3.1 下拉單選如何設(shè)置默認(rèn)值

選中對應(yīng)的選項(xiàng)內(nèi)容，選中會展示為藍(lán)色圓環(huán)，如下圖所示：

設(shè)置下拉單選組件的默認(rèn)值

展示效果：

3.2 選項(xiàng)值和顯示值可以設(shè)置不同

選項(xiàng)值和顯示值可以不同，這樣我們就能夠靈活應(yīng)對多語言、改顯示值等需求。

選項(xiàng)值和顯示值

3.3 下拉單選與關(guān)聯(lián)表單組件的區(qū)別

兩者的功能定義與使用場景不同

3.3.1 下拉單選

選項(xiàng)來源：自定義選項(xiàng)、從其他表單獲取、通過遠(yuǎn)程數(shù)據(jù)源獲取，數(shù)據(jù)聯(lián)動獲取。

適用場景：一般用于選項(xiàng)選擇類的場景，且不需要關(guān)聯(lián)出其他數(shù)據(jù)，可以使用下拉單選組件，比如請假表單的請假類型、性別等字段，可以用下拉單選組件。

3.3.2 關(guān)聯(lián)表單

選項(xiàng)來源：其他表單獲取

適用場景：一般用于數(shù)據(jù)關(guān)聯(lián)類的場景，比如合同管理場景中，在創(chuàng)建合同/訂單時，將關(guān)聯(lián)表單組件的選項(xiàng)與客戶表關(guān)聯(lián)，關(guān)聯(lián)出客戶信息等。

3.4 宜搭的下拉單選組件可以進(jìn)行批量編輯和組件類型轉(zhuǎn)化嗎？

目前組件類型不支持直接轉(zhuǎn)換，如需批量編輯下拉單選組件的選項(xiàng)，可以使用關(guān)聯(lián)其他表單數(shù)據(jù)功能。