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 注意事項
1)下拉選擇時可以使用快捷鍵,上下鍵切換,Tab 鍵確認。
2)下拉框資料為非同步載入,一次500條,捲動到最後一條時會繼續載入接下來的500條。因此下拉框選項列表框的寬度可能會隨着資料的長度而動態變化。
3)模糊搜尋時,由於需要在全部資料中搜尋對應的資料,所以資料量較大時,花費時間也較長。
2. 元件介紹
2.1 屬性
2.1.1 填報元件
下拉框元件的屬性設定介面如下圖所示:
各屬性設定項的詳細介紹如下:
注:「下拉框元件」在填報應用時,可透過在儲存格中新增值的方式設定預設值,值可以為資料字典綁定的實際值,也可以為顯示值,如:填寫華東,即可選定華東選項。
分類 | 設定項 | 詳細介紹 |
---|---|---|
基本 | 元件名稱 | 元件的名稱,手動輸入,通常與參數結合使用,如透過元件名獲取元件後將元件值傳遞給對應參數,預設為無 |
可 用 | 元件是否可用,勾選後,填報時元件可編輯;不勾選,填報時元件灰化,不可編輯,預設勾選 | |
可 見 | 元件是否可見,勾選後,填報時頁面顯示元件;不勾選,填報時頁面不顯示元件,預設勾選 | |
進階 | 水 印 | 填報時元件內顯示的淺灰色水印文字,手動輸入,以提示使用者需要輸入資訊,點選元件編輯區域後消失,預設為空 |
資料字典 | 綁定元件的待選擇項,必須設定,否則元件不顯示選項,如何設定可參考:資料字典 注:不支援透過設定儲存格字體大小和顏色來調整資料字典選項的字體大小和顏色 | |
校驗 | 允許為空 | 是否允許元件不選擇項,勾選後,允許元件不選擇;不勾選,填報校驗和提交時會提示,預設勾選 |
錯誤提示 | 不勾選「允許為空」時出現的設定項,可自訂提示資訊。預設情況下將顯示:不能為空 | |
允許直接編輯 | 是否允許使用者直接輸入值,勾選後,使用者可以直接輸入值,實現模糊搜尋,預設勾選 注:此功能不支援行動端 | |
允許自訂值 | 是否允許使用者輸入不包含在下拉選單選項中的值
|
2.1.2 參數元件
下拉框元件的屬性設定介面如下圖所示:
各屬性設定項的詳細介紹如下:
分類 | 設定項 | 詳細介紹 | ||
---|---|---|---|---|
基本 | 元件名稱 | 元件的名稱,手動輸入,通常與參數結合使用,如透過元件名獲取元件後將元件值傳遞給對應參數,預設為comboBox# | ||
可 用 | 元件是否可用,勾選後,填報時元件可編輯;不勾選,填報時元件灰化,不可編輯,預設勾選 | |||
可 見 | 元件是否可見,勾選後,填報時頁面顯示元件;不勾選,填報時頁面不顯示元件,預設勾選 | |||
進階 | 標籤名稱 | 元件的標籤屬性是用在行動端的,行動端不支援參數面板上的「標籤元件」,識別的是普通元件的「標籤名稱」屬性,所以行動端可以用元件的標籤名稱來實現標籤。 FineReport 11.0.30 及以上版本,標籤名稱支援使用公式。編輯框內輸入公式正文(等號開頭),自動計算公式結果作為最終標籤名稱 。 注:使用 i18n 函式實現標籤名稱根據語言顯示時,多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新,需手動重新整理範本才可生效 。 | ||
控 件 值 | 元件初始化時的預設值,可以為資料字典綁定的實際值,也可以為顯示值。支援字串、欄位、公式,預設為空 1)字串:字元文字,例如:華北 2)欄位:資料集欄位,資料集包括範本資料集和伺服器資料集。例如:資料集 ds1 的地區欄位 3)公式:設計器支援的公式,例如: A1 儲存格的值 | |||
資料字典 | ||||
去除重複項 | 是否合併重複項,勾選後,會將下拉選單選項中相同的項合併;不勾選,不會合並仍保留重複的選項,預設勾選 | |||
水 印 | 填報時元件內顯示的淺灰色水印文字,手動輸入,以提示使用者需要輸入資訊,點選元件編輯區域後消失,預設為空 | |||
字體大小 | 被選中的,顯示在元件框中選項的字體大小,預設為 12 注1:下拉選項中的文字大小不隨此處的字體大小變化 注2:此功能不支援行動端 | |||
校驗 | 允許為空 | 是否允許元件不選擇項,勾選後,允許元件不選擇;不勾選,填報校驗和提交時會提示,預設勾選 | ||
錯誤提示 | 不勾選「允許為空」時出現的設定項,可自訂提示資訊。預設情況下將顯示:不能為空 | |||
允許直接編輯 | 是否允許使用者直接輸入值,勾選後,使用者可以直接輸入值,實現模糊搜尋,預設勾選 注:此功能不支援行動端 | |||
允許自訂值 | 是否允許使用者輸入不包含在下拉選單選項中的值
| |||
座標.尺寸 | 元件位置 | 元件在參數面板中的位置,透過橫縱座標調整,座標會根據元件在參數面板中的位置自動顯示 | ||
元件大小 | 元件的大小,透過寬度、高度調整,若透過拖曳調整,高寬度也隨着自動調整 |
2.2 事件
事件設定介面可以為元件新增事件實現某些效果,「下拉框元件」支援的事件有初始化後、編輯前、編輯後、編輯結束、點選。如下圖所示:
選擇一種事件類型後,即可新增事件內容,「下拉框元件」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示:
選擇對應的事件回应方式新增即可,不同回应方式差別可參考:事件回应方式
2.3 行動端
行動端無可配置項。
2.4 模糊搜尋
在元件「屬性」設定中,勾選了「允許直接編輯」,下拉框選擇值時,使用者可以直接輸入值,實現模糊搜尋。如下圖所示:
「下拉框元件」的模糊搜尋邏輯為可參考:下拉框/下拉複選框/下拉樹的模糊搜尋
3. 應用範例
下拉框元件的應用,可參見以下文檔:
應用場景 | 實際效果 |
---|---|
場景描述: 當元件中參數值為空,點選查詢後,會顯示報表中的全部資料 參考文檔: | ![]() |
場景描述: 有時候報表資料量大、不分頁顯示,查看靠後的資料非常麻煩。希望能透過指定的數字快速定位到對應的行數 參考文檔: | ![]() |
場景描述: 圖表可以跟隨參數聯動 參考文檔: | ![]() |
場景描述: 利用決策報表的自動查詢功能,實現決策報表主體的下拉元件與圖表之間的自動查詢 參考文檔: | ![]() |
場景描述: 利用FVS的自動查詢功能,實現下拉元件與圖表之間的自動查詢 參考文檔: FVS下拉框元件 | ![]() |
場景描述: 使用者希望下拉列表中的資料較為完整,例如多列顯示 參考文檔: | ![]() |
場景描述: 多個下拉框可以實現填報聯動 參考文檔: | ![]() |
場景描述: 在實現填報聯動的基礎上,選擇第一個元件值後,其他聯動元件可以跟隨選擇可選範圍內的第一個值 參考文檔: | ![]() |
場景描述: 在設計報表的程式中,有部分需求需要使用填報元件來實現查詢的功能 參考文檔: | ![]() |
場景描述: 在進行填報時,使用下拉框元件根據顯示值進行填報,元件失去焦點後,顯示其對應的顯示值,而不是實際值 參考文檔: | ![]() |
場景描述: 在製作參數介面時,希望下拉元件的資料是動態的 參考文檔: | ![]() |
場景描述: 後面一個參數下拉框的值會根據前一個參數的值的改變而改變 參考文檔: | ![]() |
場景描述: 參數面板中後面的下拉框根據前面下拉框中選擇的值,預設顯示列表中第一個值 參考文檔: | ![]() |
場景描述: 參數介面中,往往需要在一個元件中動態的控制其他元件的值 參考文檔: | ![]() |
場景描述: 參數聯動查詢時,希望下拉框選擇後,複選框可以跟着選中全部所有參數值 參考文檔: | ![]() |
場景描述: 查詢面板可以透過比較符號,如大於號>或小於號<,定義無窮區間查詢 參考文檔: | ![]() |
場景描述: 在報表預覽頁面實現透過參數可以查詢資料連結下的資料庫表資訊 參考文檔: | ![]() |
場景描述: 在使用參數元件時,有時我們希望部分參數元件在沒滿足條件時不顯示,滿足條件後再顯示 參考文檔: | ![]() |
場景描述: 點選任意位置,都可以展開下拉框選項 參考文檔: | ![]() |
場景描述: 下拉框元件在中文輸入中,會主動識別漢語拼音,希望不識別拼音,只識別中文字,減少查詢效能的浪費 參考文檔: | ![]() |