全部產品
Search
文件中心

DataV:3D環圖

更新時間:Feb 25, 2025

本文介紹3D環圖的圖表樣式和配置面板的功能。

圖表樣式

3D環圖是餅圖的一種,能夠清晰智能地展示各類別在環圈內的佔比情況。3D環圖支援圖表內外多位置的標籤展示,支援指標卡樣式展示,支援自訂多系列資料配置。

配置面板

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

  • 圖表尺寸:包括組件的寬度和高度,單位為px。可單擊鎖定長寬比按鍵表徵圖鎖定組件的寬高比,等比例修改組件的寬高。再次單擊進行解鎖,解鎖後寬高比不受限制。

  • 圖表位置:包括組件的橫座標縱座標,單位為px。橫座標為組件左上方距離頁面左邊界的像素距離,縱座標為組件左上方距離頁面上邊界的像素距離。

  • 旋轉角度:以組件的中心為中心點,進行旋轉,單位為度(°)。

    • 手動輸入角度值,控制組件的旋轉角度。

    • 拖動圓圈旋轉控製圖標表徵圖內的黑點,控制組件的旋轉角度。

    • 單擊左右翻轉表徵圖表徵圖,控制組件左右翻轉樣式。

    • 單擊上下翻轉表徵圖表徵圖,控制組件上下翻轉樣式。

  • 不透明度:取值範圍為0~1。為0時,圖表隱藏;為1時,圖表全部顯示。預設為1

  • 圖形

    • 投影方式:環圖3D的投影方式,可選透視投影正交投影

    • 視覺距離:環圖3D視覺的距離,用於調節環圖的整體大小,單位預設px。

    • 旋轉角度:環圖在水平方向左右旋轉和垂直方向上下旋轉的角度值。單擊開關表徵圖表徵圖控制旋轉角度的顯隱。

      說明

      旋轉角度開啟後,對滑鼠互動中的旋轉有影響。

    • 內外徑比例:拖動滑塊設定環圖內外徑比例值。

    • 高度映射:設定3D環圖的高度映射,當開啟高度映射開關時,環圖各部分高度根據資料中的value值進行映射;當關閉高度映射開關時,環圖各部分高度都相等。

    • 高度比例:設定3D環圖的高度比例。

    • 環圖顏色:設定3D環圖的顏色。

    • 小數合并:限制展現的切片數量,並將剩下的切片合并成一個總的切片,同時可以設定合并後的分類名。單擊開關表徵圖表徵圖可開啟或關閉小數合并 。

    • 環表徵圖注:環圖的標註樣式,單擊開關表徵圖表徵圖,控制環表徵圖注配置項的顯隱。

      參數

      說明

      類型

      標註的資料類型展示類型,資料類型可選百分比預設值,展示類型可選普通型蜘蛛

      說明

      當資料量超過3條時, 建議標註的展示類型轉化為普通型

      標註欄位

      環圖的標註欄位,可選name+valuenamevalue

      分隔字元

      設定環表徵圖柱的分隔字元號,輸入br可以折行。僅在環圖的標柱欄位選擇name+value時可配置。

      小數位

      設定標註欄位的小數位,單位位。

      行高

      設定標註欄位的行高值,單位px。僅在環圖的標柱欄位選擇name+value時可配置。

      間距

      設定標註欄位距離環圖的間距值,單位px。

      文本樣式

      標柱欄位的文本樣式,包括字型樣式、文字粗細、字型大小和顏色。

  • 動畫:3D環圖的動畫樣式。

    • 自動旋轉:開啟開關,環圖即可自動旋轉,關閉開關,環圖不旋轉。

      說明

      自動旋轉配置只支援標註展示類型為普通型

    • 旋轉方向:設定3D環圖動畫的旋轉方向,可選逆時針順時針,僅在開啟自動旋轉開關時可配置。

    • 旋轉速度:設定3D環圖動畫的旋轉速度,僅在開啟自動旋轉開關時可配置。

  • 互動

    • 滑鼠互動:支援通過滑鼠操作實現旋轉、縮放和移入放大的多個互動,其中的旋轉和縮放只支援標註展示類型為普通型。

    • 提示框:在預覽或發佈頁面,滑鼠懸浮或單擊環圖時出現的提示框的樣式,單擊開關表徵圖表徵圖,控制提示框配置項的顯隱。

      參數

      說明

      觸發方式

      提示框被觸發的方式,可選,包括懸浮點擊

      顯示位置

      提示框顯示的位置樣式,可選,包括

      標題間距

      提示框中標題之間的間距,單位px。

      標題文本

      提示框中標題文本的樣式,包括文字字型樣式、文字粗細、字型大小和顏色。

      內容文本

      提示框中內容文本的樣式,包括文字字型樣式、文字粗細、字型大小和顏色。

      彈窗背景

      提示框的彈窗背景樣式。

      • 背景邊距:提示框彈窗背景在水平和垂直方向的邊距值。

      • 背景顏色:提示框的背景顏色。

      • 邊框樣式:提示框邊框的樣式,包括邊框線的線寬大小和邊框線的顏色。

  • 圖例:環圖的圖例樣式。

    參數

    說明

    圖例開關

    開啟開關,可配置圖例樣式;關閉開關,無法配置圖例樣式。

    方向

    圖例的方向,可選橫向縱向

    水平對齊

    圖例在水平方向的對齊樣式,可選左側置中右側

    垂直對齊

    圖例在垂直方向的對齊樣式,可選頂部置中底部

    文本樣式

    圖例文本的字型樣式、文字粗細、字型大小和顏色。

    分類圖例

    分類型圖例的樣式。

    • 圖例標記:圖例標記的形狀和尺寸之大小。

    • 圖例間距:不同分類圖例之間在橫向和縱向的距離。

    允許翻頁

    開啟開關,開啟圖例翻頁功能,可配置圖例數量過多需要翻頁顯示時的頁碼樣式和箭頭樣式;關閉開關,圖例內容全部展示在一頁中,無法翻頁顯示。

    • 頁碼樣式:翻頁頁碼的樣式,包括頁碼的字型、文字的粗細、字型大小的大小和顏色。

    • 箭頭樣式:翻頁樣式內箭頭的尺寸大小、箭頭預設顏色及禁用顏色。

  • 特效:展示三維圖形的著色效果。

    參數

    說明

    明暗效果

    可選,包括只顯示顏色明暗效果

    光照效果

    明暗效果選擇明暗效果時展示。

    • 主光源:設定主光源的光照強度、光照顏色、水平旋轉和垂直旋轉、投影和陰影品質。

    • 環境光線:設定主光源的光照強度和光照顏色。

    後期效果

    設定三維圖形的後期效果。

    • 高光:設定後期效果中高光的光暈強度。

    • 景深:設定後期效果中景深的大小和模糊半徑。

  • 條件:條件樣式說明。

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

    扇形顏色:開啟開關,配置該系列條件樣式中的扇形顏色;關閉開關,無法配置該系列條件下的扇形顏色。

資料面板(預設模式)

配置欄位說明

欄位

說明

name

各環形塊的類目。

value

各環形塊的值,決定各3D環圖塊占整個3D環圖的百分比。

配置項說明。

配置項

說明

受控模式

開啟開關,資產初始化狀態下不請求資料,僅通過回調ID或藍圖編輯器配置的方法發起請求資料;關閉開關,可以使用自動更新請求資料。開關預設為關閉狀態。

自動更新請求

選中後可以設定動態輪詢,還可以手動輸入輪詢的時間頻次。取消選中後則不會自動更新,需要手動重新整理頁面,或通過藍圖編輯器和回調ID事件來觸發請求更新資料。

資料來源

單擊配置資料來源,可在設定資料來源面板中修改資料來源類型和資料查詢代碼、預覽資料來源返回結果以及查看資料響應結果,詳情請參見配置資產資料

資料過濾器

資料過濾器提供資料結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器,可在設定資料來源面板配置資料過濾器指令碼,詳情請參見過濾器使用說明

資料響應結果

展示資料請求的響應結果。當資料來源發生改變時,可單擊右側的重新整理表徵圖 表徵圖,即時查看資料響應結果。

資料面板(分析模式)

重要

在使用DataV資料集提供的BI分析功能之前,系統會對3D環圖進行以下變更。

  • 資料來源3D環圖介面由待用資料切換至DataV資料集。

  • 更新DataV資料集配置(此操作不會使欄位配置丟失)。

配置欄位說明

欄位

說明

各環形塊的類目。

各環形塊的值,決定各3D環圖塊占整個3D環圖的百分比。

說明

您可以單擊切換資料面板左上方的預設模式,即可在彈窗對話方塊內確認退出分析模式並刪除該BI分析組件對應的分析器。退出分析模式後,組件資料面板為預設模式。

互動面板

互動說明

互動事件

說明

當點擊環圖時

選中啟用,開啟組件互動功能。當單擊3D環圖的環形塊時,會觸發資料請求,拋出回調值,動態載入不同扇形的資料。預設拋出資料中的namevalue值,具體配置請參見如何配置數字翻牌器組件的回調ID

當圖例被點擊時

選中啟用,開啟組件互動功能。當單擊3D環圖的圖例時,會觸發資料請求,拋出回調值,動態載入不同圖例的資料。預設拋出資料中的namechecked值,具體配置請參見如何配置數字翻牌器組件的回調ID

藍圖編輯器互動配置

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

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

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

    • 事件

      事件

      說明

      當3d環圖介面請求完成時

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

      當3d環圖介面請求失敗時

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

      當點擊環圖時

      當單擊3D環圖的環形塊時拋出的事件,同時拋出該扇形對應的資料項目。

      當圖例被點擊時

      當單擊3D環圖的圖例時拋出的事件,同時拋出該圖例對應的資料項目。

    • 動作

      動作

      說明

      請求3d環圖介面

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

      匯入3d環圖介面

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

      更新群組件配置

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

      顯示

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

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