狀態卡片組件配置與使用指南-DataV-阿里雲

本文介紹狀態卡片組件的圖表樣式和各配置項的含義。

圖表樣式

狀態卡片是文字組件的一種，支援多系列的狀態類別配置，能夠以彩色圓點的形式在可視化應用中直觀地展示多種類別的狀態資訊，比如展示一個叢集中多台伺服器的運行狀態。

配置面板

搜尋配置：單擊配置面板右上方的搜尋配置，可在搜尋配置面板中輸入您需要搜尋的配置項名稱，快速定位到該配置項，系統支援模糊比對。詳情請參見搜尋資產配置。
圖表尺寸：包括組件的寬度和高度，單位為px。可單擊表徵圖鎖定組件的寬高比，等比例修改組件的寬高。再次單擊進行解鎖，解鎖後寬高比不受限制。
圖表位置：包括組件的橫座標和縱座標，單位為px。橫座標為組件左上方距離頁面左邊界的像素距離，縱座標為組件左上方距離頁面上邊界的像素距離。
旋轉角度：以組件的中心為中心點，進行旋轉，單位為度（°）。
- 手動輸入角度值，控制組件的旋轉角度。
- 拖動表徵圖內的黑點，控制組件的旋轉角度。
- 單擊表徵圖，控制組件左右翻轉樣式。
- 單擊表徵圖，控制組件上下翻轉樣式。
不透明度：取值範圍為0~1。為0時，圖表隱藏；為1時，圖表全部顯示。預設為1。

全域

參數	說明
自動排文	開啟開關，系統會自動排文各狀態；關閉開關，可自訂各狀態的相片順序。
布局方式	組件狀態的布局方式，可選橫向布局和縱向布局。
每行個數	一行顯示的狀態數量，僅當關閉自動排文配置項後有效。

間距
參數
說明
橫向
多個狀態之間的橫向間距，取值範圍為0~100。
豎向
多個狀態之間的縱向間距，僅當狀態排列為多行時有效，取值範圍為0~100。

文本樣式

參數	說明
字型	狀態文本的字型系列，預設為微軟雅黑。
字型大小	狀態文本的大小。
字型顏色	狀態文本的顏色，請參見顏色選取器說明進行修改。
字型粗細	狀態文本的字型粗細。

狀態種類：單擊右側的或表徵圖，添加或刪除一個狀態類別。單擊或表徵圖配置多個狀態種類系列的排列樣式。單擊表徵圖，即可複製當前選中狀態種類系列配置內容並新增一個同樣配置的狀態種類系列。單擊表徵圖，即可複製當前選中狀態種類配置內容並新增一個同樣配置的狀態種類。
參數
說明
狀態類型名
狀態的類型名稱，需要與資料中的value欄位值對應。
狀態圓點顏色
此類型下，狀態圓點的顏色。

圓點樣式：狀態卡片中的圓點樣式。

參數	說明
位置	圓點相對於文本的位置，可選：在前或在後。
圓角大小	圓點的圓角大小，為0時顯示為方形，為1時顯示為圓形。
旋轉角度	圓點的旋轉角度，單位°。
間距	文字到狀態點之間的間距，單位px。

資料面板

配置欄位說明

欄位	說明
`name`	（可選）設定狀態的常值內容。
`value`	（可選）設定狀態的種類，需要與狀態種類 > 狀態類型名配置項的內容對應，並且使用狀態種類中定義的樣式進行渲染。

互動面板

此組件沒有互動事件。

藍圖編輯器互動配置

在畫布編輯器頁面，按右鍵組件，選擇匯出到藍圖編輯器。
單擊頁面左上方的表徵圖。

在藍圖編輯器配置頁面，單擊匯入節點欄內的狀態卡片組件，在畫布中可以看到如下圖所示的狀態卡片的藍圖編輯器配置參數。狀態卡片藍圖參數

事件

事件	說明
當資料請求完成時	資料介面請求返回並經過過濾器處理後拋出的事件，同時拋出處理後的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, // 動畫曲線。可選值為：linear\|easeInOutQuad\|easeInOutExpo。 "animationEasing": "linear" } };`

案例示範

本案例通過單擊輪播列表的某一行，實現狀態卡片的動態展示。

登入DataV控制台。
選擇任一可視化應用，單擊編輯，進入畫布編輯器頁面。
添加輪播列表和狀態卡片兩個組件到畫布中。
單擊輪播列表，選擇配置面板，修改自訂欄，設定三個標籤。修改全域 > 表格行數為3。
說明
- Cluster-叢集
- VM-虛擬機器
- Status-狀態

選擇資料面板，修改待用資料。

[
  {
    "Cluster": "華東",
    "VM": "vm-001",
    "Status": "正常"
  },
  {
    "Cluster": "華南",
    "VM": "vm-002",
    "Status": "未串連"
  },
  {
    "Cluster": "華西",
    "VM": "vm-003",
    "Status": "故障"
  },
  {
    "Cluster": "華北",
    "VM": "vm-004",
    "Status": "正常"
  }
]

單擊狀態卡片，修改狀態種類。
說明
- 正常-綠色
- 故障-紅色
- 未串連-白色
按右鍵組件，將兩個組件匯入藍圖編輯器中。
串連組件。

配置串列資料處理節點的處理方法。

return [
  {
    "name": data.VM,
    "value": data.Status,
  }
]

單擊頁面右上方的表徵圖，預覽展示結果。

參數	說明
橫向	多個狀態之間的橫向間距，取值範圍為0~100。
豎向	多個狀態之間的縱向間距，僅當狀態排列為多行時有效，取值範圍為0~100。

參數	說明
狀態類型名	狀態的類型名稱，需要與資料中的value欄位值對應。
狀態圓點顏色	此類型下，狀態圓點的顏色。