數字元件- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	App 版本	功能變更
11.0	-	-
11.0.21	11.0.85	「數字元件」行動端新增「允許一鍵清空」功能
11.0.30	11.0.94	標籤名稱支援使用公式，詳情參見 2.1.2 節

1.2 應用場景

1.2.1 填報元件

填報報表中可以透過該元件輸入數字資訊（整數、負數、小數），錄入填報的資料，如下圖所示：

1.2.2 參數元件

參數面板處可以透過該元件輸入數字資訊（整數、負數、小數），鍵入查詢參數，如下圖所示：

1.3 如何新增

1.3.1 填報元件

被選儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「數字元件」，如下圖所示：

1.3.2 參數應用

將參數面板元件工具欄中的「數字元件」拖入到參數面板中，如下圖所示：

2. 元件介紹

2.1 屬性

2.1.1 填報元件

「數字元件」的屬性設定介面如下圖所示：

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

注：「數字元件」在填報應用時，可透過在儲存格中新增值的方式設定預設值。

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數。預設為空。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯。預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件。預設勾選。
進階	水印	填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失。預設為空。
校驗	允許為空	是否允許元件為空值，勾選後，允許元件為空值；不勾選，填報校驗和提交時會提示。預設勾選。
	錯誤提示	不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空
	允許小數	是否允許元件輸入值帶有小數，勾選後，允許輸入小數；不勾選，無法輸入小數點。預設勾選。
	小數位數	勾選「允許小數」時出現的設定項，可自訂最大小數位數。預設為 16。
	允許負數	是否允許元件輸入值為負數，勾選後，允許輸入負數；不勾選，無法輸入負號。預設勾選。
	需要最大值	可以自訂輸入最大值，勾選後，超出最大值後，填報校驗和提交時會提示：值大於允許輸入最大值；不勾選，輸入時無最大值要求。預設不勾選。注1：小數點後精度出現 4 位及以上 9999/0000 時，會預設進位/舍入。注2：數字整體長度超過16位後，會預設進位/舍入。
	需要最小值	可以自訂輸入最小值，勾選後，低於最小值後，填報校驗和提交時會提示：值小於允許輸入最小值；不勾選，輸入時無最小值要求。預設不勾選。注：小數點後精度出現 4 位及以上 9999/0000 時，會預設進位/舍入。注2：數字整體長度超過16位後，會預設進位/舍入。
	錯誤提示	勾選「需要最大值」或者「需要最小值」後的設定項，可自訂錯誤提示項，如可設定統一的錯誤提示：超出設定範圍，不設定時，為預設顯示情況。

2.1.2 參數元件

「數字元件」的屬性設定介面如下圖所示：

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

分類	設定項	詳細設定
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為numberEditor#。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯。預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件。預設勾選。
進階	標籤名稱	元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤。 FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。
	元件值	元件初始化時的預設值，支援雙精度、欄位、公式。雙精度：具有更高精度的一種資料型資料，最多可以有15位有效數字，例如：12.35 欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的地區欄位公式：設計器支援的公式，例如： A1 儲存格的值
	水印	填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失。預設為空。
	字體大小	正文框中輸入字體的大小，預設為 12。注：此功能不支援行動端。
校驗	允許為空	是否允許元件為空值，勾選後，允許元件為空值；不勾選，填報校驗和提交時會提示。預設勾選。
	錯誤提示	不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空
	允許小數	是否允許元件輸入值帶有小數，勾選後，允許輸入小數；不勾選，無法輸入小數點。預設勾選。
	小數位數	勾選「允許小數」時出現的設定項，可自訂最大小數位數，預設為 16。
	允許負數	是否允許元件輸入值為負數，勾選後，允許輸入負數；不勾選，無法輸入負號。預設勾選。
	需要最大值	可以自訂輸入最大值，勾選後，超出最大值後，填報校驗和提交時會提示：值大於允許輸入最大值；不勾選，輸入時無最大值要求。預設不勾選。注1：小數點後精度出現 4 位及以上 9999/0000 時，會預設進位/舍入。注2：數字整體長度超過16位後，會預設進位/舍入。
	需要最小值	可以自訂輸入最小值，勾選後，低於最小值後，填報校驗和提交時會提示：值小於允許輸入最小值；不勾選，輸入時無最小值要求。預設不勾選。注1：小數點後精度出現 4 位及以上 9999/0000 時，會預設進位/舍入。注2：數字整體長度超過16位後，會預設進位/舍入。
	錯誤提示	勾選「需要最大值」或者「需要最小值」後的設定項，可自訂錯誤提示項，如可設定統一的錯誤提示：超出設定範圍，不設定時，為預設顯示情況。
座標.尺寸	元件位置	元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動示。
座標.尺寸	元件大小	元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。

2.2 事件

事件設定介面可以為元件新增事件實現某些效果，「數字元件」支援的事件有初始化後、編輯前、編輯後、編輯結束。如下圖所示：

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

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

2.3 行動端

「數字元件」支援行動端「允許一鍵清空」功能。如下圖所示：

進階：

允許一鍵清空：選擇後，允許對輸入內容一鍵刪除。

3. 應用範例

數字元件的應用，可參見以下文檔：

應用場景	實際效果
場景描述：為了防止一些人惡意填報，生成一些垃圾資料，可以透過數字元件設定效驗碼，在輸入效驗碼不正確情況下，填報「提交」按鈕不可用，無法提交，校驗碼正確時可以提交參考文檔： JS實現防止惡意提交

應用場景

實際效果

場景描述：

為了防止一些人惡意填報，生成一些垃圾資料，可以透過數字元件設定效驗碼，在輸入效驗碼不正確情況下，填報「提交」按鈕不可用，無法提交，校驗碼正確時可以提交

參考文檔：

JS實現防止惡意提交

上一篇：文字域元件

下一篇：密碼元件

有幫助
沒幫助
只是瀏覽
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

數字元件