下拉復選框元件

選擇的項顯示在元件中時是否以標籤形式顯示，預設勾選

勾選：

不勾選：  

注：此功能不支援行動端。

綁定元件的待選擇項，必須設定，否則元件不顯示選項，如何設定可參考：資料字典

注：不支援透過設定儲存格字體大小和顏色來調整資料字典選項的字體大小和顏色。

1）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"]

2）字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連接成一個字串。例如：在輸入法為英文的狀態下，將分隔符，開始符和結束符分別定義成逗號，單引號和單引號，則回傳值為：'值 1,值 2,值 3'

是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，實現模糊搜尋，預設勾選

注：此功能不支援行動端。

是否允許使用者輸入不包含在下拉選單選項中的值

• 勾選後，允許輸入不包含在下拉選單選項中的值

• 不勾選「允許自訂值」和「標籤形式顯示」，不允許輸入不包含在下拉選單選項中的值。當輸入值不包含在下拉選單選項中時，下拉複選框不會自動清除輸入值，並會彈出提示框：值不在下拉列表內

• 不勾選「允許自訂值」，勾選「標籤形式顯示」，不允許輸入不包含在下拉選單選項中的值。當輸入值不包含在下拉選單選項中時，下拉複選框會自動清除輸入值，並會彈出提示框：值不在下拉列表內

元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤。

FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。

注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。

元件初始化時的預設值，可以為資料字典時綁定的實際值，也可以為顯示值。支援字串、欄位、公式，預設為空。

1）字串：字元文字，例如：華北

多個值時，預設值格式要和元件「回傳值類型」一致，回傳值不做修改時預設用逗號隔開，如：華東,華北

分割符選擇了分號，則用分號，如：華東;華北

2）欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的產品ID欄位

若欄位有多個值，則會多選

3）公式：設計器支援的公式，例如： A1 儲存格的值

若公式對應的值為多個值，則會多選

綁定元件的待選擇項，必須設定，否則元件不顯示選項，如何設定可參考：資料字典

被選中的，顯示在元件框中選項的字體大小，預設為 12 。

注1：下拉選項中的文字大小不隨此處的字體大小變化。

注2：此功能不支援行動端。

選擇的項顯示在元件中時是否以標籤形式顯示，預設勾選。

勾選：

不勾選：

注：此功能不支援行動端。

選擇後，回傳值的格式，分為陣列和字串兩種。

1）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"]

2）字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連接成一個字串。例如：分隔符，開始符和結束符分別定義成逗號，單引號和單引號，則回傳值為：'值 1,值 2,值 3'

是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，實現模糊搜尋，預設勾選。

注：此功能不支援行動端。

是否允許使用者輸入不包含在下拉選單選項中的值

• 勾選後，允許輸入不包含在下拉選單選項中的值

• 不勾選「允許自訂值」和「標籤形式顯示」，不允許輸入不包含在下拉選單選項中的值。當輸入值不包含在下拉選單選項中時，下拉複選框不會自動清除輸入值，並會彈出提示框：值不在下拉列表內

• 不勾選「允許自訂值」，勾選「標籤形式顯示」，不允許輸入不包含在下拉選單選項中的值。當輸入值不包含在下拉選單選項中時，下拉複選框會自動清除輸入值，並會彈出提示框：值不在下拉列表內

使用下拉複選框元件，使用者可以對資料集中的多個欄位進行多值查詢，進而對資料進行篩選展示。

參考文檔：

資料集參數的多選查詢

使用下拉複選框元件可以選擇多個值，按照每個值去模糊查詢

參考文檔：

下拉複選框多值模糊查詢

在實際使用時，可以設定使下拉複選框在預覽的時候預設選中所有資料

參考文檔：

場景描述：

當報表的資料欄比較多，但資料量不是很大時，可如下圖所示實現動態欄資料展示

參考文檔：

使用函式實現動態欄