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