本文介紹輪播列表柱狀圖組件的圖表樣式和各配置項的含義。
圖表樣式
輪播列表柱狀圖是表格組件的一種,支持根據數值大小映射柱子的長度,支持以跑馬燈動畫的形式展示溢出文本,能夠以輪播列表柱圖的形式在可視化應用中直觀地展示多行、多頁的文本內容。
配置面板
- 搜索配置:單擊配置面板右上角的搜索配置,可在搜索配置面板中輸入您需要搜索的配置項名稱,快速定位到該配置項,系統支持模糊匹配。詳情請參見搜索資產配置。
- 圖表尺寸:包括組件的寬度和高度,單位為px。可單擊鎖定組件的寬高比,等比例修改組件的寬高。再次單擊進行解鎖,解鎖后寬高比不受限制。
- 圖表位置:包括組件的橫坐標和縱坐標,單位為px。橫坐標為組件左上角距離頁面左邊界的像素距離,縱坐標為組件左上角距離頁面上邊界的像素距離。
- 旋轉角度:以組件的中心為中心點,進行旋轉,單位為度(°)。
- 手動輸入角度值,控制組件的旋轉角度。
- 拖動圖標內的黑點,控制組件的旋轉角度。
- 單擊圖標,控制組件左右翻轉樣式。
- 單擊圖標,控制組件上下翻轉樣式。
- 透明度:取值范圍為[0,1]。為0時,圖表隱藏;為1時,圖表全部顯示。默認為1。
全局樣式
參數
說明
字體
組件中所有文本的字體系列,默認為微軟雅黑。
開啟動畫
打開開關,開啟動畫效果。
動畫時間
輪播時文字翻轉和柱狀圖閃光效果的總用時,單位為ms。
行間距
各柱子之間的距離。
數量
每頁顯示的文本行數。
自動輪播
打開開關,柱狀圖播完一次數據后自動重復播放。關閉開關,柱狀圖播完一次數據后不再播放。
說明開啟自動輪播后,配置不會立即生效,將會在下一次輪播后生效。
輪播時間
列表從前一頁切換到下一頁所間隔的時間,單位為ms。
排序
組件數據根據value值大小進行的排序模式,可選降序或升序。單擊圖標控制排序的顯隱。
序列號 :列表的序列號樣式,可單擊圖標控制序列號的顯隱。
參數
說明
文本
序列號文本的大小、顏色和字體粗細。
寬度
序列號的寬度,單位為px或%,輸入需要帶單位。
間隔
序列號和輪播內容之間的間隔距離,單位為px。
樣式
序列號的樣式。
內容
參數
說明
文本
內容文本的大小、顏色和字體粗細。
跑馬燈
對溢出文本使用跑馬燈動畫效果,可單擊圖標控制動畫效果的開啟或關閉。
動畫時間:溢出文本的跑馬燈動畫時間,單位為ms。
數值:數據中的
value
字段值的顯示樣式,可單擊圖標控制數值顯隱。參數
說明
字號
數值文本的大小。
顏色
數值文本的顏色。
字體粗細
數值文本的字體粗細。
間隔
數值文本與內容文本之間的距離。
千分位分隔符
打開開關,數值每到一個千分位時添加一個分隔符。
前后綴
數值的前后綴樣式,包括自定義輸入前綴和后綴內容,數值與前后綴左側和右側的間距值,單位px。
柱狀圖:列表中柱狀圖的樣式,可單擊圖標控制柱狀圖顯隱。
參數
說明
顏色
柱狀圖的顏色。
高度
柱狀圖的粗細。
流光:柱狀圖上的流光特效樣式,可單擊圖標控制流光特效的開啟或關閉。
參數
說明
顏色
流光的顏色。
長度
流光的長度。
高度
流光的粗細,超過柱狀圖部分不會顯示。
動畫間隔
間隔多久進行展示一次流光特效,單位為ms。
分割線:各行之間的分割線樣式,可單擊圖標控制分割線的顯隱。
參數
說明
顏色
多行之間分割線的顏色。
高度
分割線的粗細。
數據面板
配置字段說明
字段 | 說明 |
| 列表每行的值,對應柱狀圖的長度,數據會按照此value值的大小進行排序展示。可在數值配置項中配置value值的顯示樣式。 |
| 對應輪播列表上每行的內容。 |
配置項 | 說明 |
受控模式 | 打開開關,資產初始化狀態下不請求數據,僅通過回調ID或藍圖編輯器配置的方法發起請求數據;關閉開關,可以使用自動更新請求數據。開關默認為關閉狀態。 |
自動更新請求 | 選中后可以設置動態輪詢,還可以手動輸入輪詢的時間頻次。取消選中后則不會自動更新,需要手動刷新頁面,或通過藍圖編輯器和回調ID事件來觸發請求更新數據。 |
數據源 | 單擊配置數據源,可在設置數據源面板中修改數據源類型和數據查詢代碼、預覽數據源返回結果以及查看數據響應結果,詳情請參見配置資產數據。 |
數據過濾器 | 數據過濾器提供數據結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器,可在設置數據源面板配置數據過濾器腳本,詳情請參見過濾器使用說明。 |
數據響應結果 | 展示數據請求的響應結果。當數據源發生改變時,可單擊右側的圖標,實時查看數據響應結果。 |
交互面板
此組件沒有交互事件。
藍圖編輯器交互配置
- 在畫布編輯器頁面,右鍵單擊組件,選擇導出到藍圖編輯器。
- 單擊頁面左上角的圖標。
在藍圖編輯器配置頁面,單擊導入節點欄內的輪播列表柱狀圖組件,在畫布中可以看到如下圖所示的輪播列表柱狀圖的藍圖編輯器配置參數。
事件
事件
說明
當數據接口請求完成時
數據接口請求返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
當數據接口請求失敗時
數據接口請求失敗時(請求失敗的情況可能是:網絡問題或接口報錯等)返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
動作
動作
說明
請求數據接口
重新請求服務端數據,上游數據處理節點或圖層節點拋出的數據將作為參數。例如輪播列表柱狀圖配置了API數據源為
https://api.test
,傳到請求數據接口動作的數據為{ id: '1'}
,則最終請求接口為https://api.test?id=1
。導入數據接口
按組件繪制格式處理數據后,導入組件,重新繪制。不需要重新請求服務端數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
更新組件配置
動態更新組件的樣式配置。需要先在組件的配置面板中,單擊復制配置到剪貼板,獲取組件配置數據。再根據需要在藍圖編輯器配置頁面的數據處理節點中更改對應樣式的字段值。
顯示
顯示組件,參考數據示例如下。
return { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" };
隱藏
隱藏組件,參考數據示例如下。
return { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" };
切換顯隱狀態
切換組件顯示或者隱藏,參考數據示例如下。
return { "animationIn": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" }, "animationOut": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" } };
移動
將組件移動到指定位置,參考數據示例如下。
return { // 移動方式。絕對定位:to,相對定位:by。默認值:to。 "positionType": "to", // 指定位置。x坐標,y坐標。 "attr": { "x": 0, "y": 0 }, // 動畫方式。 "animation": { "enable": false, // 動畫延時。 "animationDuration": 1000, // 動畫曲線??蛇x值為:linear|easeInOutQuad|easeInOutExpo。 "animationEasing": "linear" } };