1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.30 | 標籤名稱支援使用公式，詳情參見 2.1.2 節 |
1.2 應用場景
1.2.1 填報元件
填報報表中可以透過該元件下拉選擇多個選項資訊，錄入填報的資料，如下圖所示：
1.2.2 參數元件
參數面板處可以透過該元件下拉選擇多個選項資訊，鍵入查詢參數，如下圖所示：
1.3 新增方式
1.3.1 填報元件
被選儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「下拉複選框元件」，如下圖所示：
1.3.2 參數元件
將參數面板元件工具欄中的「下拉複選框元件」拖入到參數面板中，如下圖所示：
1.4 注意事項
1）下拉框資料為非同步載入，一次500條，捲動到最後一條時會繼續載入接下來的500條。因此下拉框選項列表框的寬度可能會隨着資料的長度而動態變化。
2）模糊搜尋時，由於需要在全部資料中搜尋對應的資料，所以資料量較大時，花費時間也較長。
2. 元件介紹
2.1 屬性
2.1.1 填報元件
「下拉複選框元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下：
注：「下拉複選框元件」在填報應用時，可透過在儲存格中新增值的方式設定預設值，值可以為資料字典綁定的實際值，也可以為顯示值。預設選擇多個值時，預設值格式要和元件「回傳值類型」一致，回傳值不做修改時預設用逗號隔開，如：華東,華北
| 分類 | 設定項 | 詳細介紹 |
|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無 |
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選 | |
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選 | |
| 進階 | 水 印 | 填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空 |
| 標籤形式顯示 | 選擇的項顯示在元件中時是否以標籤形式顯示，預設勾選 勾選： 不勾選： 注：此功能不支援行動端。 | |
| 資料字典 | 綁定元件的待選擇項，必須設定，否則元件不顯示選項，如何設定可參考：資料字典 注：不支援透過設定儲存格字體大小和顏色來調整資料字典選項的字體大小和顏色。 | |
| 回傳值類型 | 選擇後，回傳值的格式，分為陣列和字串兩種。 1）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"]
2）字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連接成一個字串。例如：在輸入法為英文的狀態下，將分隔符，開始符和結束符分別定義成逗號，單引號和單引號，則回傳值為：'值 1,值 2,值 3'
| |
| 校驗 | 允許為空 | 是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選 |
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 | |
| 允許直接編輯 | 是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，實現模糊搜尋，預設勾選 注：此功能不支援行動端。 | |
| 允許自訂值 | 是否允許使用者輸入不包含在下拉選單選項中的值
|
2.1.2 參數元件
「下拉複選框元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下：
| 分類 | 設定項 | 詳細介紹 | ||
|---|---|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為comboCheckBox#。 | ||
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | |||
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | |||
| 進階 | 標籤名稱 | 元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤。 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'
| |||
| 校驗 | 允許為空 | 是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。 | ||
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 | |||
| 允許直接編輯 | 是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，實現模糊搜尋，預設勾選。 注：此功能不支援行動端。 | |||
| 允許自訂值 | 是否允許使用者輸入不包含在下拉選單選項中的值
| |||
| 座標.尺寸 | 元件位置 | 元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。 | ||
| 元件大小 | 元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。 | |||
2.2 事件
事件設定介面可以為元件新增事件實現某些效果，「下拉複選框元件」支援的事件有初始化後、編輯前、編輯後、編輯結束、點選。如下圖所示：
選擇一種事件類型後，即可新增事件內容，「下拉複選框元件」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示：
選擇對應的事件回应方式新增即可，不同回应方式差別可參考：事件回应方式
2.3 行動端
行動端無可配置項。
2.4 模糊搜尋
在元件「屬性」設定中，勾選了「允許直接編輯」，下拉複選框選擇值時，使用者可以直接輸入值，實現模糊搜尋。如下圖所示：
「下拉複選框元件」的模糊搜尋邏輯可參考：下拉框/下拉複選框/下拉樹的模糊搜尋
3. 應用範例
下拉複選框元件的應用，可參見以下文檔：
| 應用場景 | 實際效果 |
|---|---|
| 場景描述： 使用下拉複選框元件，使用者可以對資料集中的多個欄位進行多值查詢，進而對資料進行篩選展示。 參考文檔： | |
| 場景描述： 使用下拉複選框元件可以選擇多個值，按照每個值去模糊查詢 參考文檔： | |
| 場景描述： 在實際使用時，可以設定使下拉複選框在預覽的時候預設選中所有資料 參考文檔： 下拉複選框預設選中全部值 | |
場景描述： 當報表的資料欄比較多，但資料量不是很大時，可如下圖所示實現動態欄資料展示 參考文檔： | |
| 場景描述： 在範本預覽時,使用者可使用下拉複選框元件對資料進行多值查詢展示 參考文檔： FVS下拉框元件 | |
