全部產品
Search
文件中心

DataV:Echarts 熱力圖

更新時間:Mar 28, 2026

本文介紹Echarts 熱力圖的圖表樣式和配置面板的功能。

圖表樣式

image

配置面板image

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

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

    • 左側:網格與組件左側邊界的距離,預設為 3%。支援以下幾種輸入:

      • 具體像素值,例如 20

      • 相對於容器高寬的百分比,例如 20%

      • leftcenterright,組件會根據相應的位置自動對齊。

    • 頂部:網格與組件上側邊界的距離,預設為 60。支援以下幾種輸入:

      • 具體像素值,例如 20

      • 相對於容器高寬的百分比,例如 20%

      • leftcenterright,組件會根據相應的位置自動對齊。

    • 右側:網格與組件右側邊界的距離,預設為 4%。支援以下幾種輸入:

      • 具體像素值,例如 20

      • 相對於容器高寬的百分比,例如 20%

      • leftcenterright,組件會根據相應的位置自動對齊。

    • 底部:網格與組件下側邊界的距離,預設為 3%。支援以下幾種輸入:

      • 具體像素值,例如 20

      • 相對於容器高寬的百分比,例如 20%

      • leftcenterright,組件會根據相應的位置自動對齊。

    • 寬度:網格的寬度,值預設值為 auto,寬度自適應。

    • 高度:網格的高度,值預設值為 auto,高度自適應。

    • 調適型配置:勾選後,柱狀圖進行調適型配置;去勾選,柱狀圖根據您配置的樣式進行布局。

    • 背景色:參考顏色選取器說明,修改網格的背景顏色,預設透明。

    • 邊框色:參考顏色選取器說明,修改網格的邊框顏色,預設透明。

    • 邊框粗細:單擊+-號,或手動輸入數值,調整網格邊框粗細。

  • x軸:單擊右側的眼睛表徵圖顯示x軸樣式。x軸

    • 位移:x軸相對於預設位置的位移,預設為0

    • 名稱:自訂x軸名稱。

    • 名稱位置:x軸名稱的位置,可選,包括起點置中終點,預設值為 終點

    • 名稱樣式

      • 顏色:參考顏色選取器說明,修改x軸名稱文本的顏色。

      • 字型樣式:x軸名稱的字型風格。

      • 字型粗細:x軸名稱的字型粗細。

      • 字型:x軸名稱的字型系列。

      • 字型大小:單擊+-號,或手動輸入數值,修改x軸名稱的字型大小。

    • 名稱間隔:單擊+-號,或手動輸入數值,修改座標軸名稱與軸線之間的距離。

    • 名稱旋轉:單擊+-號,或手動輸入數值,修改座標軸名稱旋轉的角度值。

    • 反向:勾選後,座標軸反向顯示;去勾選,座標軸正向顯示。

    • 最小值:座標軸刻度最小值,預設值為資料最小值,表示取資料在該軸上的最小值作為最小刻度。不設定時會自動計算最小值保證座標軸刻度的均勻分布。

    • 最大值:座標軸刻度最大值,預設值為資料最大值,表示取資料在該軸上的最大值作為最大刻度。不設定時會自動計算最大值保證座標軸刻度的均勻分布。

    • 自動調整:勾選後,座標刻度不會強制包含零刻度。只在數值軸中有效,設定了最大值和最小值後該配置項無效。

    • 分割段數:單擊+-號,或手動輸入數值,設定座標軸的分割段數。不設定時會自動計算最小值保證座標軸刻度的均勻分布。需要注意的是這個分割段數只是個預估值,最後實際顯示的段數會在這個基礎上根據分割後座標軸刻度顯示的易讀程度作調整。在類目軸中無效。

    • 最小間隔大小:單擊+-號,或手動輸入數值,設定座標軸最小間隔大小。例如可以設定成1保證座標軸分割刻度顯示成整數。只在數值軸或時間軸中有效。

    • 軸線:單擊右側的眼睛表徵圖顯示x軸軸線。

      • 在零上:x 軸或者 y 軸的軸線是否在另一個軸的 0 刻度上,只有在另一個軸為數值軸且包含 0 刻度時有效。

      • 軸線樣式

        • 顏色:參考顏色選取器說明,修改x軸軸線的顏色。

        • 寬度:單擊+-號,或手動輸入數值,修改x軸軸線的寬度。

        • 類型:x軸分割線軸線的類型。可選,包括實線虛線

        • 透明度:單擊+-號,或手動輸入數值,修改x軸軸線的透明度。範圍為 [0,1]。

    • 刻度:單擊右側的眼睛表徵圖顯示x軸刻度。

      • 和標籤對齊:勾選後,刻度標記和標籤對齊。類目軸中在勾選了留白後有效。

      • 分割間隔:單擊+-號,或手動輸入數值,修改座標軸刻度的顯示間隔,在類目軸中有效。

      • 內部:勾選後,座標軸刻度朝內;去勾選,座標軸刻度朝外。

      • 長度:單擊+-號,或手動輸入數值,修改座標軸刻度的長度。

      • 軸線樣式

        • 顏色:參考顏色選取器說明,修改刻度標記的顏色。

        • 寬度:單擊+-號,或手動輸入數值,修改刻度標記的寬度。

        • 類型:座標軸軸線的類型。可選,包括實線虛線

        • 透明度:單擊+-號,或手動輸入數值,修改刻度標記的透明度。範圍為 [0,1]。

    • 刻度標籤:單擊右側的眼睛表徵圖顯示x軸刻度標籤。

      • 分割間隔:座標軸刻度標籤的顯示間隔,在類目軸中有效,預設會採用標籤不重疊的策略間隔顯示標籤。可以設定成 0 強制顯示所有標籤。如果設定為 1,表示隔一個標籤顯示一個標籤,如果值為 2,表示隔兩個標籤顯示一個標籤,以此類推。

      • 內部:勾選後,座標軸刻度標籤朝內;去勾選,座標軸刻度標籤朝外。

      • 旋轉:刻度標籤旋轉的角度,在類目軸的類目標籤顯示不下的時候可以通過旋轉防止標籤之間重疊。旋轉的角度從 -90 度到 90 度。

      • 外間距:刻度標籤與軸線之間的距離。

      • 顯示最小標籤:勾選後,顯示最小的刻度標籤。預設自動判定,即如果標籤重疊,不會顯示最小的刻度標籤。

      • 顯示最大標籤:勾選後,顯示最大的刻度標籤。預設自動判定,即如果標籤重疊,不會顯示最大的刻度標籤。

      • 文本樣式

        • 顏色:參考顏色選取器說明,修改座標軸刻度標籤的顏色。

        • 字型樣式:座標軸刻度標籤文字的字型風格。

        • 字型粗細:座標軸刻度標籤文字的字型粗細。

        • 字型:座標軸刻度標籤文字的字型系列。

        • 字型大小:座標軸刻度標籤文字的字型大小。

        • 對齊:座標軸刻度標籤文字水平對齊,預設為自動,可選,支援自動靠左對齊置中對齊靠右對齊

        • 對齊:可選,支援頂部對齊置中對齊底部對齊

    • 分割線:單擊右側的眼睛表徵圖顯示分割線。

      • 分割間隔:單擊+-號,或手動輸入數值,修改座標軸分隔線的顯示間隔,在類目軸中有效,預設會採用分割線不重疊的策略間隔顯示分割線。可以設定成 0 強制顯示所有分割線。如果設定為 1,表示隔一個分割線顯示一個分割線,如果值為 2,表示隔兩個分割線顯示一個分割線,以此類推。

      • 軸線樣式

        • 寬度:單擊+-號,或手動輸入數值,修改x軸分割線的線寬。

        • 類型:x軸分割線軸線的類型。可選,包括實線虛線

        • 透明度:單擊+-號,或手動輸入數值,修改x軸分割線的透明度,範圍為 [0,1]。

    • 分割地區:單擊右側的眼睛表徵圖顯示分割地區。

      • 分割間隔:單擊+-號,或手動輸入數值,修改座標軸分隔地區的顯示間隔,在類目軸中有效,預設會採用分割地區不重疊的策略間隔顯示分割地區。可以設定成 0 強制顯示所有分割地區。如果設定為 1,表示隔一個分割地區顯示一個分割地區,如果值為 2,表示隔兩個分割地區顯示一個分割地區,以此類推。

      • 地區樣式

        • 透明度:單擊+-號,或手動輸入數值,修改分割地區的透明度,範圍為 [0,1]。

    • 座標軸指標:單擊右側的眼睛表徵圖顯示座標軸指標。

      • 類型:指標類型,包括直線指標陰影指標

      • 自動吸附:勾選後,座標軸指標自動吸附到點上。這個功能在數值軸和時間軸上比較有意義,可以自動尋找細小的數值點。

      • 初始值:座標軸指標的初始位置,預設為0

      • 狀態:座標軸指標當前的狀態,勾選後顯示,去勾選後隱藏。

      • 標籤:單擊右側的眼睛表徵圖顯示座標軸指標的標籤。

        • 小數精度:文字標籤中數值的小數點精度,預設根據當前軸的值自動判斷,也可以指定一個整數值,如 2,表示保留兩位小數。

        • 外間距:勾選後,座標軸指標標籤與座標軸之間有一定間距。去勾選,座標軸指標標籤與座標軸之間沒有間距。

        • 文本樣式

          • 顏色:參考顏色選取器說明,修改座標軸指標標籤文本的顏色。

          • 字型樣式:座標軸指標標籤文本的字型風格。

          • 字型粗細:座標軸指標標籤文本的字型粗細。

          • 字型:座標軸指標標籤文本的字型系列。

          • 字型大小:座標軸指標標籤文本的字型大小。

        • 背景色:座標軸指標文字標籤的背景顏色。

        • 邊框色:座標軸指標文字標籤的邊框顏色。

        • 邊框粗細:座標軸指標文字標籤的邊框粗細。

      • 軸線樣式

        • 顏色:參考顏色選取器說明,修改軸線的顏色。

        • 寬度:單擊+-號,或手動輸入數值,修改軸線的寬度。

        • 類型:座標軸軸線的類型。可選,包括實線虛線

        • 透明度:單擊+-號,或手動輸入數值,修改軸線的透明度。範圍為 [0,1]。

      • 拖拽手柄:單擊右側的眼睛表徵圖顯示拖拽手柄。

        • 大小:單擊+-號,或手動輸入數值,修改拖拽手柄的大小。

        • 外間距:單擊+-號,或手動輸入數值,修改拖拽手柄中心點和軸的距離。

        • 顏色:拖拽手柄的顏色。

        • 重新整理頻率:手柄拖拽時觸發大屏更新周期,單位為毫秒,調大這個數值可以改善效能,但是降低體驗。

  • y軸:請參考x軸樣式進行配置。

  • 視覺映射:單擊右側的眼睛表徵圖顯示視覺映射。視覺映射

    • 最小值:手動輸入數值或選擇資料最小值,修改視覺映射的最小值。

    • 最大值:手動輸入數值或選擇資料最大值,修改視覺映射的最大值。

    • 視覺元素:單擊右側的加號表徵圖垃圾桶表徵圖表徵圖,添加或刪除一個顏色樣式。 單擊橫柏拉圖標豎柏拉圖標表徵圖配置多個顏色樣式的排列樣式。單擊複製表徵圖表徵圖,即可複製當前選中的顏色樣式配置並新增一個同樣配置的顏色樣式。

    • 拖拽手柄:單擊眼睛按鈕顯示拖拽手柄樣式。

    • 即時:勾選後,即時顯示;去勾選,不即時顯示。

    • 反向:勾選後,反向顯示;去勾選,正向顯示。

    • 小數精度:您可以手動輸入數值或單擊+-號,改變視覺映射小數精度的具體數值。

    • 圖形寬度:您可以手動輸入數值或單擊+-號,改變視覺映射圖形寬度的具體數值。

    • 圖形高度:您可以手動輸入數值或單擊+-號,改變視覺映射圖形高度的具體數值。

    • 對齊:單擊下拉式清單,選擇視覺映射的對齊。包括自動靠左對齊置中對齊靠右對齊

    • 懸浮連結:勾選後,顯示懸浮連結;去勾選,不顯示懸浮連結。

    • 左側:您可以自動輸入視覺映射左側的具體資料百分比,值預設值為auto。

    • 頂部:您可以自動輸入視覺映射頂部的具體資料百分比,值預設值為auto。

    • 右側:您可以自動輸入視覺映射右側的具體資料百分比,值預設值為auto。

    • 底部:您可以自動輸入視覺映射底部的具體資料百分比,值預設值為auto。

    • 朝向:單擊下拉式清單,選擇朝向樣式。包括水平垂直

    • 內邊距:您可以手動輸入數值或單擊+-號,改變視覺映射內邊距的具體數值。

    • 背景色:參考顏色選取器說明,修改視覺映射的背景顏色。

    • 邊框色:參考顏色選取器說明,修改視覺映射的邊框顏色。

    • 邊框粗細:單擊+-號,或手動輸入數值,修改視覺映射的邊框粗細。

    • 文本樣式

      • 顏色:參考顏色選取器說明,修改視覺映射文本樣式的顏色。

      • 字型樣式:您可以自動輸入視覺映射字型樣式的具體內容,預設值為normal。

      • 字型粗細:您可以自動輸入視覺映射字型粗細的具體內容,預設值為normal。

      • 字型:您可以自動輸入視覺映射字型的具體內容,預設值為sans-serif。

      • 字型大小:您可以手動輸入數值或單擊+-號,改變視覺映射文本字型大小的具體數值大小。

  • 提示框:單擊右側的眼睛表徵圖顯示提示框。提示框

    • 觸發條件:自訂觸發類型,可選,包括滑鼠移動觸發滑鼠點擊觸發滑鼠移動點擊同時觸發

    • 背景色:參考顏色選取器說明,修改提示框的背景顏色。

    • 邊框色:參考顏色選取器說明,修改提示框的邊框顏色。

    • 邊框粗細:單擊+-號,或手動輸入數值,修改背景框的邊框粗細。

    • 內邊距:單擊+-號,或手動輸入數值,修改背景框的內邊距,單位px,預設各方向內邊距為5。

    • 文本樣式

      • 顏色:參考顏色選取器說明,修改提示框文本的顏色。

      • 字型樣式:提示框文本的字型風格。

      • 字型粗細:提示框文本的字型粗細。

      • 字型:提示框文本的字型系列。

      • 字型大小:提示框文本的字型大小。

  • 圖形元素圖形元素

    • 模糊大小:單擊+-號,或手動輸入數值,修改圖形元素的模糊大小。

    • 最小透明度:單擊+-號,或手動輸入數值,修改圖形元素的最小透明度。

    • 最大透明度:單擊+-號,或手動輸入數值,修改圖形元素的最大透明度。

    • 靜態:勾選後,標籤為靜態無法互動。

    • 標籤

      • 普通項:單擊右側的眼睛表徵圖顯示普通項(沒有響應滑鼠事件的柱子)標籤文本。

        • 文本樣式

          • 顏色:參考顏色選取器說明,修改普通項標籤文本的顏色。

          • 字型樣式:普通項標籤文本的字型風格。

          • 字型粗細:普通項標籤文本的字型粗細。

          • 字型:普通項標籤文本的字型系列。

          • 字型大小:普通項標籤文本的字型大小。

      • 重點項:單擊右側的眼睛表徵圖顯示重點項(響應滑鼠事件的柱子)標籤文本。

        • 文本樣式

          • 顏色:參考顏色選取器說明,修改重點項標籤文本的顏色。

          • 字型樣式:重點項標籤文本的字型風格。

          • 字型粗細:重點項標籤文本的字型粗細。

          • 字型:重點項標籤文本的字型系列。

          • 字型大小:重點項標籤文本的字型大小。

資料面板

資料

配置欄位說明

欄位

說明

x

用於配置熱力圖中每個x軸的類目,即x軸的值。

y

用於配置熱力圖中每個y軸的類目,即y軸的值。

value

用於配置熱力圖中每個熱力圖的值。

互動面板

互動

互動說明

互動

說明

當點擊資料項目時

選中啟用,開啟組件互動功能。熱力圖組件擁有互動配置,當單擊選中某個資料項目時拋出回調值,預設拋出資料中的xy等欄位。具體配置請參見組件回調ID配置

當視覺映射改變時

選中啟用,開啟組件互動功能。熱力圖組件擁有互動配置,當視覺映射改變時拋出回調值,預設拋出資料中的selected欄位。具體配置請參見組件回調ID配置

藍圖編輯器互動配置

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

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

  3. 在藍圖編輯器配置頁面,單擊匯入節點欄內的熱力圖組件,在畫布中可以看到如下圖所示的熱力圖的藍圖編輯器配置參數。image

    • 事件

      事件

      說明

      當資料介面請求完成時

      資料介面請求返回並經過過濾器處理後拋出的事件,同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。

      當資料介面請求失敗時

      資料介面請求失敗時(請求失敗的情況可能是:網路問題或介面報錯等)返回並經過過濾器處理後拋出的事件,同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。

      當點擊資料項目時

      當單擊熱力圖的圖形時拋出的事件,同時拋出對應的資料項目。

      當視覺映射改變時

      當單擊熱力圖的視覺映射時拋出的事件,同時拋出對應的資料項目。

    • 動作

      動作

      說明

      請求資料介面

      重新請求服務端資料,上遊資料處理節點或圖層節點拋出的資料將作為參數。例如熱力圖配置了API資料來源為https://api.test,傳到請求資料介面動作的資料為{ id: '1'},則最終請求介面為https://api.test?id=1

      匯入資料介面

      按組件繪製格式處理資料後,匯入組件,重新繪製。不需要重新請求服務端資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。

      高亮顯示

      動作傳入資料為object類型,參數包括seriesName(系列名)、seriesIndex(系列索引)、dataIndex(資料索引)和name(資料名)。資料樣本:

      {  
          "seriesName": "",  
          "seriesIndex": 1,  
          "dataIndex": 1,  
          "name": ""
      }

      取消高亮

      動作傳入資料為object類型,參數包括seriesName(系列名)、seriesIndex(系列索引)、dataIndex(資料索引)和name(資料名)。資料樣本:

      {  
          "seriesName": "",  
          "seriesIndex": 1,  
          "dataIndex": 1,  
          "name": ""
      }

      顯示提示框

      動作傳入資料為object類型,參數包括dataindex(資料索引)、name(資料名)、x(橫座標位置)和y(縱座標位置)。資料樣本:

      { 
          "dataIndex": 1,  
          "name": "",  
          "x": 1,  
          "y": 1
      }

      隱藏提示框

      隱藏提示框,不需要參數。

      視覺對應範圍

      動作傳入資料為object類型,參數為selected(分段對象)。

      說明

      連續型的為一個表示數值範圍的數組;離散型的是一個對象,索引值是類目或者分段的索引。

      更新群組件配置

      動態更新組件的樣式配置。需要先在組件的配置面板中,單擊複製配置到剪貼簿,擷取組件配置資料。再根據需要在藍圖編輯器配置頁面的資料處理節點中更改對應樣式的欄位值。

      顯示

      顯示組件,參考資料樣本如下。

      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"
            }
          }