1. 概述
適用場景：安裝了「FineVis資料視覺化」插件的使用者，可參考本文了解 FVS 範本的相關功能。
1.1 版本
| 報表伺服器版本 | 插件版本 | 功能變動 |
|---|---|---|
| 11.0.6 | V1.x | V1.x 版本請參見文檔：FVS複選按鈕組元件歷史版本 |
| 11.0.16 | V2.0.0 | 舊版本預覽時，預設有全選選項。新增設定項，可自行設定是否顯示全選按鈕 |
| 11.0.16 | V2.0.1 | 元件新增內容樣式設定，詳情請參見 2.1.2 節 |
| 11.0.22 | V2.8.0 | 元件名稱與參數分離，新增綁定參數邏輯，詳情參見 2.1.1 節 |
| V2.10.0 | 單選按鈕組元件和複選按鈕組元件合併為按鈕組元件，移至元件>列表中 | |
| V3.3.0 | 選項值來源新增支援排序，詳情參見 2.1.1 節 |
1.2 功能簡介
複選按鈕組元件在範本預覽時，支援透過選擇不同選項，透過參數聯動其他組件。效果如下圖所示：
組件動畫請參見：FVS組件動畫 。
組件樣式請參見：FVS組件樣式屬性 。元件名稱在「內容」中設定。
2. 功能介紹
2.1 元件內容
複選按鈕組元件可設定的內容如下圖所示：
2.1.1 內容
各設定項的詳細介紹如下表所示：
| 設定項 | 詳細介紹 |
|---|---|
| 綁定參數 | 值為參數名稱，用於與參數綁定。預設為空，需根據實際參數進行設定 支援已有參數的綁定，也可以直接輸入新值以建立新的參數 |
| 選項值來源 | 綁定元件的待選擇項，必須設定，否則元件不顯示選項，如何設定可參考：資料字典 V3.3.0 及以上版本，新增「選項值排序」設定，可對選項值來源進行排序。 支援預設、升冪、降冪、自訂 僅在「類型設定」為資料庫表、資料查詢和公式時支援設定 對顯示值進行排序 注：若僅設定了「實際值」，則對實際值進行排序 排序方式選擇「自訂」且已設定實際值和顯示值時，下方出現自訂排序彈窗
|
| 去除重複項，勾選後，會將下拉選項中相同的項合併；不勾選，不會合並仍保留重複的選項。預設勾選 | |
| 回傳值 | 陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值1","值2","值3"] |
字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連結成一個字串。 例如：分隔符定義為逗號，起始符和結束符均定義為單引號，回傳值為 '值1,值2,值3'
| |
| 全選 | 可選擇是否「支援全選」，預設勾選，勾選後可透過選項中的「全選」按鈕實現一鍵全選 |
| 預設值 | 可設定複選按鈕組元件預設選中的選項，包括如下 3 種： 1）自訂字串：可直接輸入正文，輸入多個值時，可實現多選。但輸入多個值時，格式需與元件「回傳值」類型一致，回傳值不做修改時預設用英文逗號隔開，如：華東,華北
2）欄位：可選擇資料集中欄位，若欄位有多個值，則會多選
3）公式：點選右側 fx 輸入公式，若公式對應的值為多個值，則會多選
|
| 權限 | 設定頁面初始預覽時該元件是否可編輯，預設勾選可編輯 |
| 校驗 | 空值校驗：是否允許元件為空值，勾選後，允許取消選中；不勾選，可設定校驗提示文字， |
2.1.2 內容樣式
1）無線電鈕
無線電鈕可選樣式範本有四種：預設樣式、膠囊按鈕、聯排按鈕、圖文按鈕。內容樣式根據「樣式範本」不同，設定項有所不同。
| 樣式範本 | 其他設定項 |
|---|---|
| 預設樣式 | 可設定選項的佈局方式和字元樣式。 佈局方式可選擇如下三種：
|
| 膠囊按鈕 | 可設定佈局方式、字元樣式、按鈕樣式和圓角。 佈局方式同樣可選擇三種：自動填充、固定欄數、固定列數。
|
| 聯排按鈕 | 可設定佈局方式、字元樣式、按鈕樣式和圓角。 佈局方式可選擇自然佈局或等分佈局，不支援按欄或按列填充。
|
| 圖文按鈕 | 可設定佈局方式、字元樣式、按鈕樣式。 佈局方式同樣可選擇三種：自動填充、固定欄數、固定列數。 按鈕樣式中「按鈕圖示」的顯示邏輯需注意：
|
2）複選按鈕
複選按鈕可選樣式範本有兩種：預設樣式、膠囊按鈕。
| 樣式範本 | 其他設定項 |
|---|---|
| 預設樣式 | 可設定選項的佈局方式和字元樣式。 佈局方式可選擇如下三種：
|
| 膠囊按鈕 | 可設定佈局方式、字元樣式、按鈕樣式和圓角。 佈局方式同樣可選擇三種：自動填充、固定欄數、固定列數。
|
2.2 元件交互事件
點選「交互>新增事件」，可新增 JavaScript 事件實現更多效果。複選按鈕組元件支援「初始化後事件」和「點選事件」。如下圖所示：
點選具體的某一個事件，會彈出 JavaScript 事件設定框。如下圖所示：
注：關於 FVS 支援的 JavaScript 可參考文檔 FVS企業戰情室支援的JSAPI場景 。
3. 範例
3.1 準備範本
1）點選設計器左上角「檔案>建立企業戰情室報表」。
2）建立資料庫查詢 ds1 ，輸入 SQL 查詢語句 SELECT * FROM 銷量 where 銷售員 in ('${spe}') ，並給參數 spe 設定預設值為「孫林」，即預設取出孫林的銷量資料。
如下圖所示：
3.2 新增複選按鈕組元件
1）點選組件區「元件>列表>按鈕組」，將元件新增到頁面中。
在右側配置面板「內容」中將綁定參數設定為「spe」，即可與資料集中定義的 spe 參數匹配。如下圖所示：
2）綁定複選按鈕組元件的選項值來源，選擇類型為「資料庫表」，選擇 FRDemoTW 中銷量表的「銷售員」欄位。
設定預設值為「孫林」，如下圖所示：如下圖所示：
3）若需要設定為複選按鈕，需勾選「開啟多選」
為了匹配 SQL 中的 in 語句，需要將元件回傳值設定為「字串」，手動輸入分隔符為 ',' 。
設定分隔符後，再設定預設值，需保持相同格式。例如本例要設定多個預設值，則需要使用分隔符 ',' 隔開，輸入「孫林','金士鵬」。
然後根據情況設定佈局。如下圖所示
3.3 新增折線圖
點選組件區「圖表>折線圖」，將組件新增到頁面中，給折線圖綁定含有 spe 參數的資料集中資料。如下圖所示：
3.4 效果預覽
3.4.1 PC 端
點選右上角「儲存」，點選「預覽」。
當按鈕組為無線電鈕時，折線圖顯示對應銷售員的產品銷量。如下圖所示：
當按鈕組為複選按鈕時，選擇單個或多個按鈕，折線圖顯示對應銷售員的產品銷量。如下圖所示：
3.4.2 行動端
預覽方式請參考 FVS行動端預覽
無線電鈕組效果如下圖所示：
複選按鈕組效果如下圖所示：
4. 範本下載
點選下載範本：FVS按鈕組元件範例.fvs
