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 節 |
1.2 功能簡介
複選按鈕組元件在範本預覽時,支援透過選擇不同選項,透過參數聯動其他組件。效果如下圖所示:
組件動畫請參見:FVS組件動畫 。
組件樣式請參見:FVS組件樣式屬性 。元件名稱在「內容」中設定。
2. 功能介紹
2.1 元件內容
複選按鈕組元件可設定的內容如下圖所示:
2.1.1 內容
各設定項的詳細介紹如下表所示:
設定項 | 詳細介紹 |
---|---|
綁定參數 | 值為參數名稱,用於與參數綁定。預設為空,需根據實際參數進行設定 支援已有參數的綁定,也可以直接輸入新值以建立新的參數 |
選項值來源 | 綁定元件的待選擇項,必須設定,否則元件不顯示選項,如何設定可參考:資料字典 |
去除重複項,勾選後,會將下拉選項中相同的項合併;不勾選,不會合並仍保留重複的選項。預設勾選 | |
回傳值 | 陣列:回傳值類型是陣列型,例如:勾選三個值,回傳值為:["值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