數字翻牌器常用于展示數值、計數或時間等信息,可與其他組件進行交互,在可視化應用中展示數據的實時變化情況。本文為您介紹數字翻牌器的使用詳情。
組件介紹
應用場景
數字翻牌器常用于時鐘、計時器、計數器等設備,或金融領域顯示金額、企業展示某個指標等場景。例如,展示企業的某個指標數據,通過指標的變化快速判斷是否存在經營異常。
效果展示
數字翻牌器通常由標題、前/后綴及翻牌器內容組成。示例使用數字翻牌器展示某地區的日銷售金額,效果如下。
使用限制
翻牌器內容僅支持顯示Number
類型。若您的數據非Number
類型,則平臺會將該內容視為異常字符,并自動替換為指定內容。詳情請參見異常字符處理。
前提條件
添加數字翻牌器
登錄DataV控制臺。
在
單擊目標看板,進入看板的畫布編輯頁面。在左側導航欄的
列表下,單擊數字翻牌器組件,添加該組件至畫布。
您也可使用全局搜索添加相關組件。
接入業務數據
添加組件后,您可將已準備的業務數據接入組件進行顯示。單擊數字翻牌器,在右側的數據源頁簽,即可選擇該組件所要呈現的數據。
翻牌器接收的數據字段介紹如下。
字段
描述
name
(可選)數字翻牌器的標題內容。不為空時會覆蓋樣式中的配置;為空時會使用
配置項中的內容。value
數字翻牌器的具體數值。
prefix
(可選)數字翻牌器的前綴內容。不為空時會覆蓋樣式中的配置;為空時會使用
配置項中的內容。suffix
(可選)數字翻牌器的后綴內容。不為空時會覆蓋樣式中的配置;為空時會使用
配置項中的內容。示例翻牌器的數據結構及效果展示如下。
[ { "name": "這是標題", "value": 232425 } ]
數據源的核心配置項介紹如下。
配置項
描述
選擇數據源
支持接入CSV文件、API、各類數據庫等多種類型數據,詳情請參見支持的數據源類型。您可使用可視化表格或代碼方式編輯數據字段。
配置過濾器(可選)
用于自定義過濾代碼,實現數據的結構轉換、篩選、展示和簡單的計算,詳情請參見管理數據過濾器。
配置數據映射
用于將所選數據源中的字段映射至組件對應的字段上,實現數據的實時匹配。單擊圖標可配置字段樣式。
查看響應結果
用于實時展示組件所接入的數據。當組件數據源發生變化時,此處會對應展示最新數據。
單擊數據響應結果,可查看編寫的數據字段代碼。
單擊查看示例,可查看數據源接收的數組類型及代碼示例。您可參考示例編寫相關字段。
其他數據請求配置:
禁止加載態:勾選后,在組件更新或預覽數據看板時,將不呈現組件初始化時的加載內容。
受控模式:勾選后,組件在初始化狀態下不會請求數據。此時僅支持通過藍圖編輯器或全局變量事件發起數據請求。
自動更新請求:勾選后,平臺會根據您設置的輪詢時間,動態輪詢更新數據;不勾選,則需手動刷新頁面,或通過藍圖編輯器和全局變量事件來觸發請求更新數據。
配置數字翻牌器
樣式配置
數字翻牌器的樣式分為基礎配置和全量配置兩個維度(在樣式頁簽頂部即可切換),基礎配置僅涉及圖表的顏色及文字配置;全量配置涉及的配置項更加全面。本文以全量配置示例,介紹相關配置詳情。
您也可單擊圖標,通過關鍵詞搜索,快速定位到所需配置項,搜索支持模糊匹配。詳情請參見搜索配置項。
翻牌器的標題、前后綴內容也可在數據源中獲取。平臺會優先使用數據源中的配置內容,若數據源中相關內容為空,則會采用樣式中的配置內容。
相關配置項介紹如下。
配置項 | 描述 | 圖示 |
全局配置 | 定義組件在數據看板中的位置分布、透明程度、交互穿透。
| |
基礎樣式配置 | 定義標題文本的大小、顏色、陰影效果、標題與翻牌器的相對位置和間距,以及翻牌器的字號自適應效果。同時,支持自定義組件初始化及出現異常字符時的顯示內容。
| |
翻牌器配置 | 定義翻牌器內容(包括數字、前后綴)的整體布局、數字的樣式和布局、以及前后綴的字體樣式和陰影效果。 數字配置說明如下:
| |
交互配置 | 設置翻牌器的動畫效果(例如,動畫時長、數據抖動修正)和手勢光標。
|
高級配置
可定義翻牌器與其他組件間的交互,以及數據傳遞關系。相關配置項介紹如下。
配置項 | 描述 | 圖示 |
交互事件 | 定義與其他組件間的交互行為,實現組件聯動。例如,可通過翻牌器接入當前地區多個店鋪的銷售數據表格。當店鋪銷售數據發生變化,翻牌器將實時顯示當前地區的日總銷售金額情況。 單擊圖標,即可定義相關交互事件及交互動作。 | |
關聯全局變量 | 可在組件中關聯全局參數,實現組件間的參數傳遞,進行組件交互。單擊圖標,即可開啟相應指令,并為該指令關聯所需全局變量。 |
藍圖交互
可通過藍圖編輯器使用可視化連線方式,定義組件間的交互關系及行為邏輯。
操作步驟
在畫布編輯頁面,單擊頂部菜單欄左側的圖標,進入藍圖編輯器。
在圖層節點列表,鼠標懸停至數字翻牌器組件,單擊圖標,添加該組件至主畫布。
通過連線方式,按需配置相關組件的藍圖交互效果。
示例如下。
配置項介紹
相關交互事件及動作的介紹如下。
類別 | 子類別 | 描述 |
事件 | 當數據更新時 | 當組件數據更新時拋出該事件。 |
當數據請求狀態變化時 | 當數據請求狀態變化時拋出該事件。狀態值包括Loading、Success、Error。 | |
當前值變化時 | 當前數值發生變化時拋出該事件,同時拋出該值對應的數據項,數據示例如下。
| |
當點擊翻牌器時 | 當單擊翻牌器時拋出的事件,同時拋出對應的數據項,數據示例如下。
| |
事件 | 導入數據 | 數據按組件繪制格式處理后導入組件,并重新繪制。無需重新請求服務端數據,數據示例如下。
|
請求數據 | 重新請求服務端數據,上游數據處理節點或圖層節點拋出的數據將作為參數。例如,數字翻牌器配置的API數據源為 | |
清零當前值 | 把當前數字置為零,無需參數。 | |
移動 | 將組件移動到指定位置,數據示例如下。
| |
切換顯隱 | 切換組件為顯示或隱藏,無需參數。 | |
顯示 | 顯示組件,數據示例如下。
| |
隱藏 | 隱藏組件,數據示例如下。
| |
更新組件配置 | 動態更新組件的樣式配置。
|
案例演示
數字翻牌器的使用示例,請參見實現動態數據加和。