下拉單選

1. 適用場(chǎng)景

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

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

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

2. 基礎(chǔ)功能

2.1 清除按鈕

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

組件的清除按鈕

效果如下：

2.2 可搜索

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

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

效果如下：

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

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

無(wú)數(shù)據(jù)時(shí)顯示內(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)類型選擇自定義時(shí)，可以在下面添加選項(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ù)來(lái)源，常見(jiàn)于和外部系統(tǒng)的聯(lián)動(dòng)，可以參考如下配置：

設(shè)置路徑：

接口格式:

入?yún)?/h5>

• q : 用戶搜索內(nèi)容，搜索框發(fā)起請(qǐng)求的時(shí)候，會(huì)默認(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. 常用問(wèn)題

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

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

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

展示效果：

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

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

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

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

兩者的功能定義與使用場(chǎng)景不同

3.3.1 下拉單選

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

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

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

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

適用場(chǎng)景：一般用于數(shù)據(jù)關(guān)聯(lián)類的場(chǎng)景，比如合同管理場(chǎng)景中，在創(chuàng)建合同/訂單時(shí)，將關(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ù)功能。