DataV：垂直膠囊柱狀圖（v3.0及以上版本）

圖表樣式

垂直膠囊柱狀圖是柱狀圖的一種，與基本柱圖相比，垂直膠囊柱狀圖組件支援使用堆疊的方式展示多系列資料，因此可以在較小的可視化應用空間內，智能地展示多維的資料差異。

配置面板

• 搜尋配置：單擊配置面板右上方的搜尋配置，可在搜尋配置面板中輸入您需要搜尋的配置項名稱，快速定位到該配置項，系統支援模糊比對。詳情請參見搜尋資產配置。

• 圖表尺寸：包括組件的寬度和高度，單位為px。可單擊表徵圖鎖定組件的寬高比，等比例修改組件的寬高。再次單擊進行解鎖，解鎖後寬高比不受限制。
• 圖表位置：包括組件的橫座標和縱座標，單位為px。橫座標為組件左上方距離頁面左邊界的像素距離，縱座標為組件左上方距離頁面上邊界的像素距離。
• 旋轉角度：以組件的中心為中心點，進行旋轉，單位為度（°）。
  • 手動輸入角度值，控制組件的旋轉角度。
  • 拖動表徵圖內的黑點，控制組件的旋轉角度。
  • 單擊表徵圖，控制組件左右翻轉樣式。
  • 單擊表徵圖，控制組件上下翻轉樣式。
• 不透明度：取值範圍為0~1。為0時，圖表隱藏；為1時，圖表全部顯示。預設為1。

• 圖表

  • 邊距：柱圖地區與組件上下左右四個邊界之間的距離，單位預設px。

  • 最多載入：自訂輸入資料載入限制數量，系統最多載入您輸入的資料記錄條數進行布局、繪製與計算，以保證可視化應用展示效果。

  • 柱圖樣式：柱圖中每個柱子的樣式。

    參數	說明
    柱內間距	柱子到膠囊殼的距離，取值範圍為0~10，單位為px。
    描邊顏色	膠囊柱子描邊的顏色。
    外框顏色	膠囊外部邊框的顏色，請參見顏色選取器說明進行修改。
    外框粗細	膠囊外部邊框的粗細。

  • 值標籤：每個柱子值標籤的樣式，可單擊表徵圖控制值標籤的顯隱。

    參數	說明
    文本	值標籤文本的字型樣式、文字粗細、字型大小和顏色。
    位置	值標籤文本的顯示位置，可選頂部、中間和底部三種樣式。
    空值資料	開啟開關，值標籤資料為空白時候依舊顯示在組件柱體中；關閉開關，值標籤資料為空白時候不顯示在組件柱體中。

  • 圖例：柱圖的圖例樣式，可單擊表徵圖控製圖例的顯隱。

    參數	說明
    文本	圖例文本的字型樣式、文字粗細、字型大小和顏色。
    布局	各圖例之間的位置關係。 間距 左右間距：相鄰圖例之間左右兩側的距離，僅當有多個系列時該配置項才有效。 上下間距：圖例與組件和柱圖上下邊界的距離。 位置：圖例相對於組件起始座標的位置，可選頂部居左、頂部置中、頂部居右、底部居左、底部置中和底部居右。

• 座標軸：組件座標軸包括x軸和y軸兩種。

  • x軸

    • x軸可見：開啟開關，組件內x軸樣式顯示可見；關閉開關，組件內x軸樣式不可見。

    • 兩邊留白：x軸左右兩邊留下空白的距離，取值範圍為0~1。

    • 分割間隔：x軸上柱子與柱子之間的間隔距離，數值越大柱子越細，間隔更大，取值範圍為0~0.95。

    • 軸標籤：柱圖的x軸的軸標籤樣式，可單擊表徵圖控制x軸的軸標籤顯隱。

      參數	說明
      文本	x軸標籤文本的字型樣式、文字粗細、字型大小和顏色。
      軸標籤展示	角度：x軸標籤的角度樣式，可選水平、傾斜和垂直三種。 數量：x軸標籤的數量。 軸單位：x軸標籤的單位。

    • 軸線：柱圖的x軸軸線的樣式，可單擊表徵圖控制x軸軸線的顯隱。

      顏色：x軸軸線的顏色。

    • 網格線：柱圖的x軸網格線的樣式，可單擊表徵圖控制x軸網格線的顯隱。

      顏色：x軸網格線的顏色。

  • y軸

    • y軸可見：開啟開關，組件內y軸樣式顯示可見；關閉開關，組件內y軸樣式不可見。

    • 範圍：y軸的最大值的範圍值。

      最大值：y軸的最大值，支援自訂輸入，也支援系統選擇：

      • 資料最大值：取資料中的最大值。

      • 自動取整：系統根據資料中的最大值、最小值和指標點的個數自動計算。

    • 軸標籤：柱圖的y軸的軸標籤樣式，可單擊表徵圖控制y軸的軸標籤顯隱。

      參數	說明
      顯示格式	y軸標籤數值顯示格式的樣式，可選預設、11（整數）、11.1（浮點數）、11.11（浮點數）、11%、11.1%和11.11%。
      文本	y軸標籤文本的字型樣式、文字粗細、字型大小和顏色。
      軸標籤展示	y軸標籤展示的數量和單位。

    • 軸線：柱圖的y軸軸線的樣式，可單擊表徵圖控制y軸軸線的顯隱。

      顏色：y軸軸線的顏色。

    • 網格線：柱圖的y軸網格線的樣式，可單擊表徵圖控制y軸網格線的顯隱。

      顏色：y軸網格線的顏色。

• 系列

  資料數列：單擊右側的或表徵圖，添加或刪除一個資料數列。 單擊或表徵圖配置多個資料數列的排列樣式。單擊表徵圖，即可複製當前選中資料數列配置內容並新增一個同樣配置的資料數列。

  參數	說明
  系列名	資料數列的命名，可自訂。為空白時，系統會將組件資料中的s欄位值作為系列名進行顯示。如果不為空白，您需要保證資料返回的順序。
  顏色	此系列下柱圖的顏色。

• 其它

  • 緩動動畫：柱狀圖的動畫效果樣式，可單擊表徵圖可開啟或關閉動畫效果。

    參數	說明
    動畫設定	緩動效果：動畫的緩動效果，系統提供多種常見的動畫緩動效果供您選擇。 各系列依次動畫：開啟開關，各系列柱圖依次按順序播放動畫；關閉開關，全部柱形一起播放動畫。
    入場動畫	組件第一次渲染動畫的時間長度，單位為ms。
    更新動畫	更新動畫時間長度：組件資料更新時動畫持續的時間，單位為ms。 是否從之前位置開始：開啟開關，組件資料更新時從上一個資料的位置開始播放動畫；關閉開關，組件資料更新時從初始位置開始播放動畫。

  • 提示框：在預覽或發佈頁面，滑鼠懸浮或單擊柱圖時出現的提示框的樣式，可單擊表徵圖可開啟或關閉提示框。

    參數	說明
    消失延遲時間	當不滿足觸發條件時，提示框就會消失，此配置項設定提示框消失前延遲的時間，單位為ms。
    觸發方式	觸發類型：提示框被觸發的目標類型，可選，包括資料項目和座標軸。 觸發動作：提示框被觸發的動作，可選，包括懸浮和點擊。
    文本樣式	提示框中文本的樣式，包括文字字型樣式、文字粗細、字型大小和顏色。
    背景框樣式	提示框的背景框樣式。 背景色：提示框的背景顏色。 自訂：提示框的寬度和高度，單位為px。單擊表徵圖可開啟或關閉自義定提示框。 內邊距：提示框的內部邊距，單位為px。 位移量 水平位移量：提示框相對滑鼠箭頭位置的水平位移量，單位為px。 垂直位移量：提示框相對滑鼠箭頭位置的垂直位移量，單位為px。 邊框 邊框粗細：提示框邊框的粗細，單位為px。 邊框顏色：提示框的邊框顏色。

資料面板

配置欄位說明

互動面板

選中啟用，開啟組件互動功能。當單擊垂直膠囊柱狀圖的柱子時，會觸發資料請求，拋出回調值，動態載入不同柱子的資料。預設拋出資料中的x、y和s值，具體配置請參見如何配置數字翻牌器組件的回調ID。

藍圖編輯器互動配置

1. 在畫布編輯器頁面，按右鍵組件，選擇匯出到藍圖編輯器。

2. 單擊頁面左上方的表徵圖。

3. 在藍圖編輯器配置頁面，單擊匯入節點欄內的垂直膠囊柱狀圖組件，在畫布中可以看到如下圖所示的垂直膠囊柱狀圖的藍圖編輯器配置參數。

   • 事件

     事件	說明
     當垂直膠囊柱狀圖介面請求完成時	資料介面請求返回並經過過濾器處理後拋出的事件，同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。
     當垂直膠囊柱狀圖介面請求失敗時	資料介面請求失敗時（請求失敗的情況可能是：網路問題或介面報錯等）返回並經過過濾器處理後拋出的事件，同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。
     當點擊資料項目時	當單擊垂直膠囊柱狀圖的柱子時拋出的事件，同時拋出該柱子對應的資料項目。

   • 動作

     動作	說明
     請求垂直膠囊柱狀圖介面	重新請求服務端資料，上遊資料處理節點或圖層節點拋出的資料將作為參數。例如垂直膠囊柱狀圖配置了API資料來源為https://api.test，傳到請求垂直膠囊柱狀圖介面動作的資料為{ id: '1'}，則最終請求介面為https://api.test?id=1。
     匯入垂直膠囊柱狀圖介面	按組件繪製格式處理資料後，匯入組件，重新繪製。不需要重新請求服務端資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。
     高亮	高亮資料項目對應的元素。參考資料樣本如下。 return { "data": {}, "options": { "style": { "stroke": "#f00", "fill": "" }, "selectMode": "single", "cancelHighlightFirst": false } }
     取消高亮	取消資料項目對應元素的高亮。參考資料樣本如下。 return { "data": {}, "options": { "mode": "single" } }
     清空組件	清空組件資料，不需要參數。
     更新群組件配置	動態更新組件的樣式配置。需要先在組件的配置面板中，單擊複製配置到剪貼簿，擷取組件配置資料。再根據需要在藍圖編輯器配置頁面的資料處理節點中更改對應樣式的欄位值。
     顯示	顯示組件，參考資料樣本如下。 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" } }