1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
1.2 應用場景
在報表的具體應用中，經常使用「元件」來實現不同的功能。根據使用方式可將元件分為填報元件和參數元件兩大類，填報時使用的元件為填報元件，參數介面使用的元件為參數元件，這兩種元件的型別基本相同，只是在使用方面略微有所不同。本文整理元件相關文檔，使用者可根據本文快速尋找所需元件文檔。
注：元件事件具體介紹請參見：元件事件
2. 元件分類
元件型別詳細統計如下表所示：
注1：所有元件的「元件名稱」均不支援為空或重複。名稱要遵循規則，否則會導致範本錯誤，命名規則可參考：參數命名規則
注2：元件的「屬性」設定介面，所有輸入框型別的位置都不支援寫 HTML ，如 
元件型別 | 具體元件 | 元件簡介 | 參考文檔 |
|---|---|---|---|
| 參數元件/填報元件 | 文字元件 | 用於填寫或者輸入短文字，一般用於暱稱、名稱、字數少且固定的內容的填寫。
| 文字元件 |
| 文字域元件 | 相比文字元件支援換行符，當使用者需要輸入或編輯較長文字時可使用該元件，比如簡歷中的工作經驗、個人特長等。
| 文字域元件 | |
| 數字元件 | 可透過該元件輸入數字資訊（整數、負數、小數），當使用者想要使用數值時可以使用，比如填寫銷量，訂單數量這種場景。
| 數字元件 | |
| 密碼元件 | 在輸入過程中不會直接顯示出輸入內容，一般可透過該元件輸入密碼資訊，錄入密碼。
| 密碼元件 | |
| 按鈕元件 | 呈現一個按鈕形式，一般用於點選操作。給按鈕新增一些事件導致點選後可觸發某些報表操作，如點選按鈕查詢，點選按鈕提交、刪除、插入一行、展開報表等等。
| 按鈕元件 | |
| 複選按鈕元件 | 一個按鈕，兩個值，勾選和不勾選，分別對應選擇與不選擇，適合用於判斷“是”、“否”選項的場景。
| 複選按鈕元件 | |
| 單選按鈕組元件 | 可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中選擇其中一個，適合多個選項選一個的場景，比如選擇請假型別。
| 單選按鈕組元件 | |
| 複選按鈕組元件 | 可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中可以選擇多個，適合多個選項選擇數可以大於 1 的場景。
| 複選按鈕組元件 | |
| 下拉框元件 | 可以有多個值，展開選項後下拉選擇一個值，一般用於選擇某個選項資訊，從多個選項中選擇其中一個。
| 下拉框元件 | |
| 下拉複選框元件 | 可以有多個值，展開選項後下拉可以選擇多個值，一般用於從多個選項中選擇幾個選項。
| 下拉複選框元件 | |
| 日期元件 | 當使用者需要輸入一個時間，可以使用日期元件，彈出時間面板進行選擇。
| 日期元件 | |
| 下拉樹元件 | 可以有多個值，展開選項後下拉選擇一個值，選項值是具有多層樹狀結構的資料。
| 下拉樹元件 | |
| 檢視表樹元件 | 可以有多個值，選擇一個值，選項值是具有多層樹狀結構的資料。和下拉樹比較，選項不是下拉的，是直接呈現出來的。
| 檢視表樹元件 | |
| 填報元件 | 檔案元件 | 用於上傳附件，比如圖片，Word、PDF等附件。
| 檔案元件 |
| 列表元件 | 允許多個選項值，列表展示，可選擇其中的一個選項值。
| 列表元件 | |
| 網頁框元件 | 一般用於在報表頁面中嵌入其他網頁，如報表中嵌入一個官網網頁。
| 網頁框元件 | |
| 參數元件 | 標籤元件 | 一般可以寫一些提示、標題的內容，不能輸入內容，和文字框相比沒有邊框，只有文字。
| 標籤元件 |
| 查詢按鈕 | 點選該按鈕後可查詢資料，屬性和按鈕一致，但是內建了查詢，不用自己設定查詢。
| - | |
| 預定義元件 | 一般應用於自訂比較複雜且需要重複使用元件，自己定義一個元件，之後可以重複使用。
| 元件管理 |
3. 元件與參數的綁定方式
1）在使用參數元件時，當已經完成全局參數、範本參數或資料集參數設定後，編輯參數面板，選擇全部新增即可新增與參數綁定的參數元件，如下圖所示：
2）編輯參數面板，選擇需要的元件，設定參數元件的名稱為對應的參數名也可以完成元件與參數綁定。例如：設定範本參數為貨主地區，編輯參數面板，拖入下拉框元件，設定元件名稱為貨主地區。如下圖所示：
3）填報元件與參數綁定範例可參考：JS实现使用填报页面的控件查询 。
4. 注意事項
4.1 瀏覽器推薦
推薦使用谷歌核心瀏覽器或者高版本的ie瀏覽器，比如Google Chrome、Microsoft Edge、IE11等。對於低版本IE瀏覽器，比如IE8和IE相容模式，部分元件相關功能可能無法使用。
4.2 資料字典聯動會清空元件值
當前功能設計下，元件在觸發資料字典聯動時，會清空被聯動元件的值。
4.3 有元件值的參數面板元件在初始化時就會計算資料字典
帶有資料字典設定的參數面板元件，如果沒有預設值，則其資料字典會在點選元件觸發選項時才會計算；如果有預設值，則在元件初始化的時候就會計算資料字典。所以當資料字典的 sql 執行速度較慢的情況下，設定預設值會對範本整體載入速度有明顯影響。
4.4 文字和數字元件輸入不符合校驗規則的值後，會傳回上一次輸入值
設定了校驗規則的文字或者數字元件，當輸入值不符合規則的時候，會有相應提示，並且當前輸入值會被清空，傳回上一次輸入值。
4.5 元件資料字典的數字丟失精度
問題描述
注：11.0.6 及之後的版本，元件的資料字典數字體別精度更加準確，不會再出現以下問題。
當元件資料字典使用的欄位型別為數字體別時，例如 bigint，有可能會出現丟失精度的問題，如圖所示：
解決方案
需要將數字體別轉為字串型別，例如下圖所示在 sql 中進行轉換。
