複選按鈕元件- FineReport帮助文档 - 全面的报表使用教程和学习资料

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 使用說明

複選按鈕、無線電鈕組、複選按鈕組的差別：

複選按鈕僅有一個按鈕，按鈕兩個值 true 或者 false ,分別對應選擇與不選擇，適合是否選項的場景。
無線電鈕組可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中選擇其中一個，適合多個選項選一個的場景。
複選按鈕組也可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中可以選擇多個，適合多個選項選擇數可以大於 1 的場景。

如下圖所示：

2. 元件介紹

2.1 屬性

2.1.1 填報元件

「複選按鈕元件」的屬性設定介面如下圖所示：

各屬性設定項的詳細介紹如下：

注：「複選按鈕元件」值為 true 或 false，填報應用時，勾選對應 true ；不勾選對應 false；不做任何操作，填入 NULL 。可透過在儲存格中新增值的方式設定預設值，不設定預設為 NULL。

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
進階	文本	元件附帶的標籤內容，將會顯示在按鈕右側，預設為空。

2.1.2 參數元件

「複選按鈕元件」的屬性設定介面如下圖所示：

各屬性設定項的詳細介紹如下：

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設checkBox#。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
進階	標籤名稱	元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤。 FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。
	文本	元件附帶的標籤內容，將會顯示在按鈕右側，預設為空。
	元件值	元件初始化時的預設值，支援布林型、公式、欄位，預設為 false，即不勾選。布林型：true 或者 false，勾選 true 按鈕後即為選定，不勾選即為 false ，不選定，例如：勾選公式：透過公式寫入 true 或者 false，例如： A1 儲存格的值為 true，這裏寫 A1，即為選定欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的「產品ID」欄位值為 true，這裏綁定欄位後，即為選定應用範例可參考：複選按鈕、複選按鈕組元件預設值
	字體大小	「正文」字體的大小，即顯示在按鈕右側的標籤字體大小，預設為12 。注：此功能不支援行動端使用。
座標.尺寸	元件位置	元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。
座標.尺寸	元件大小	元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。

2.2 事件

事件設定介面可以為元件新增事件實現某些效果，「複選按鈕元件」支援的事件有初始化後、狀態改變。如下圖所示：

選擇一種事件類型後，即可新增事件內容，「複選按鈕元件」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示：

選擇對應的事件回应方式新增即可，不同回应方式差別可參考：事件回应方式

2.3 行動端

行動端無可配置項。

行動端預覽時，決策報表和參數面板中的複選按鈕顯示方式有變化，顯示為滑動開關類型。如下圖所示：

3. 應用範例

複選按鈕元件的應用，可參見以下文檔：

應用場景	實際效果
場景描述：在參數或者填報介面，新增「複選按鈕元件」和「複選按鈕組元件」時，預設是未選中的，可以透過設定變成預設選中，或者「複選按鈕組元件」預設選中多個參考文檔：複選按鈕、複選按鈕組元件預設值
場景描述：對於資料量較大的報表，可以採用複選按鈕元件自訂一個選項彈窗進行查詢參考文檔： JS實現自訂選項彈窗
場景描述：在做匯總報表時，可以透過複選按鈕元件實現只對勾選複選框所在行的值進行動態求和參考文檔：複選框選中行求和

應用場景

實際效果

場景描述：

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

參考文檔：

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

場景描述：

對於資料量較大的報表，可以採用複選按鈕元件自訂一個選項彈窗進行查詢

參考文檔：

JS實現自訂選項彈窗

場景描述：

在做匯總報表時，可以透過複選按鈕元件實現只對勾選複選框所在行的值進行動態求和