複選按鈕組元件

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

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

是否根據待選擇的項調整展示欄數，勾選後，根據待選擇的項展示欄數；不勾選，需自行設定展示欄數，若展示不下將截斷展示，預設勾選。

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）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"]

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

則回傳值為：'值 1,值 2,值 3'

根據元件選項擴展的列數，顯示區域不同：

1）若實際列數＜最大顯示列數，則組件區域的高度自動擴展，顯示全部選項，無多餘空白列，無捲軸

2）若實際列數≥最大顯示列數，則組件區域的高度先擴展，顯示最大顯示列數，其餘透過捲軸顯示

3）若最大顯示列數為 0 ，組件區域由組件寬高比例決定，組件顯示列數由組件區域決定，顯示不下將出現捲軸

組件區域由組件寬高比例決定，高度無法自由擴展

組件顯示列數由組件區域決定，顯示不下將出現捲軸，不受最大顯示列數約束

場景描述：

在參數或者填報介面，新增「複選按鈕元件」和「複選按鈕組元件」時，預設是未選中的，可以透過設定變成預設選中，或者「複選按鈕組元件」預設選中多個

參考文檔：

複選按鈕、複選按鈕組元件預設值

場景描述：

在參數面板中，新增了「複選按鈕組元件」，勾選「支援全選」後，會出現一個「全選」的按鈕，若不希望出現此按鈕，也可進行設定，預設全選

參考文檔：

JS實現複選按鈕組元件預設全選

場景描述：

製作調查問卷類的填報範本時，可以透過複選按鈕組元件限制複選框組選中的個數

參考文檔：

JS限制複選框選中個數

场景描述：

复选按钮组控件在模板预览时，支持通过选择不同选项，通过参数联动其他组件

参考文档：

FVS复选按钮组控件