瀑布圖全量選擇時各配置項的含義 - DataV

本文介紹瀑布圖全量選擇時各配置項的含義。

圖表樣式

瀑布圖是柱狀圖的一種，支援自訂x軸和y軸、多類目資料差值配置以及瀑布式的資料升降展示，可以在較小的資料看板內，智能地展示資料總計上升或者下降的差異。

樣式面板

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

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

圖形

參數	說明
圖表邊距	單擊表徵圖，控製圖表邊距的顯隱。開啟開關後，可配置瀑布柱圖地區與組件上下左右四個邊界之間的距離，單位預設px。
柱子寬度	柱子的寬度值，單位px。單擊表徵圖，控制柱子寬度的顯隱。
增加	類目資料為正數顯示上升趨勢的柱子的標題和顏色，顏色請參見顏色選取器說明。單擊表徵圖，控制增加配置項的顯隱。
減少	類目資料為負數時顯示下降趨勢的柱子的標題和顏色，顏色請參見顏色選取器說明。單擊表徵圖，控制減少配置項的顯隱。
總計	所有類目資料合計後的柱子的標題和顏色，顏色請參見顏色選取器說明。單擊表徵圖，控制總計配置項的顯隱。
牽引線	瀑布圖之間的牽引線樣式，包括線的形狀、線的粗細和線的顏色，可單擊表徵圖控制X軸軸線樣式的顯隱。說明當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。
柱子標籤	柱子的標籤樣式，單擊表徵圖，控制柱子標籤配置項的顯隱。標籤欄位：標籤的內容需要和資料面板中欄位的內容對應，預設擷取`y`欄位內容。數值格式：設定標籤的數值格式，可選預設、11（整數）、11.1（浮點數）、11.11（浮點數）、11%（百分比）、11.1%（百分比）、1,111（千分位）和1,111.1（千分位）。更多資料顯示格式請參見資料顯示格式說明，僅在標籤欄位選擇`range`或`y`時顯示。前尾碼：設定柱子標籤的前尾碼內容。標籤位置：選擇標籤內容的顯示位置，可選頂部、中間和底部。相對位移：柱子標籤相對柱子在垂直和水平方向的位移量，單位為px。文本樣式：柱子標籤的文本樣式，包括文本的字型樣式、文字粗細、字型大小和顏色。文本描邊：柱子標籤的文本描邊樣式，包括描邊線的粗細值和顏色。

座標：組件座標軸包括X軸和Y軸兩種。

X軸

X軸顯示：開啟開關，組件內X軸樣式顯示可見；關閉開關，組件內X軸樣式不可見。
資料類型：X軸資料的類型，可選數值型、類目型和時間型。

顯示範圍：X軸的資料最小值和最大值的顯示範圍，僅在資料類型配置項選擇數值型時可配置。

參數	說明
最小值	X軸的最小值，支援自訂輸入，也支援系統選擇資料最小值，取資料中的最小值。
最大值	X軸的最大值，支援自訂輸入，也支援系統選擇資料最大值，取資料中的最大值。

軸線：瀑布圖的X軸軸線樣式，包括線的類型、線的粗細和線的顏色，可單擊表徵圖控制X軸軸線樣式的顯隱。
說明
當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

軸標題：瀑布圖的X軸軸標題樣式，可單擊開關表徵圖表徵圖控制X軸軸標題的顯隱。

參數	說明
標題顯示	軸標題顯示的文字內容。
展示方式	軸標題的展示方式，包括標題的角度值和標題的位移值。
文本樣式	軸標題文本的字型樣式、文字粗細、字型大小和顏色。

軸標籤：瀑布圖的X軸軸標籤樣式，可單擊開關表徵圖表徵圖控制X軸軸標籤的顯隱。

參數	說明
顯示格式	標籤數值顯示格式的樣式，可選預設、11（整數）、11.1（浮點數）、11.11（浮點數）、11%（百分比）、11.1%（百分比）、1,111（千分位）和1,111.1（千分位）。更多資料顯示格式請參見資料顯示格式說明。僅在資料類型選擇數值型時可配置。
兩端間距	標籤距離軸線兩端之間的距離，單位%。
標籤展示	標籤的展示樣式，包括：期望的X軸刻度的數量、標籤的前尾碼內容、標籤的角度值、位移量和標籤展示時候的對齊。
文本樣式	軸標籤文本的字型樣式、文字粗細、字型大小和顏色。

刻度標記：瀑布圖的X軸刻度標記樣式，包括刻度標記的長度值、粗細值和顏色，可單擊表徵圖控制X軸刻度標記樣式的顯隱。
網格線：瀑布圖的X軸網格線的樣式，包括網格線的線型樣式、粗細和顏色，可單擊表徵圖控制X軸網格線的顯隱。
說明
當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

Y軸

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

顯示範圍：Y軸的資料最小值和最大值的顯示範圍。

參數	說明
最小值	Y軸的最小值，支援自訂輸入，也支援系統選擇資料最小值，取資料中的最小值。
最大值	Y軸的最大值，支援自訂輸入，也支援系統選擇資料最大值，取資料中的最大值。

軸線：瀑布圖的Y軸軸線樣式，包括線的類型、線的粗細和線的顏色，可單擊表徵圖控制Y軸軸線樣式的顯隱。

軸標題：瀑布圖的Y軸軸標題樣式，可單擊開關表徵圖表徵圖控制Y軸軸標題的顯隱。

參數	說明
標題顯示	軸標題顯示的文字內容。
展示方式	軸標題的展示方式，包括標題的角度值和標題的位移值。
文本樣式	軸標題文本的字型樣式、文字粗細、字型大小和顏色。

軸標籤：瀑布圖的Y軸軸標籤樣式，可單擊開關表徵圖表徵圖控制Y軸軸標籤的顯隱。

參數	說明
顯示格式	軸標籤數值顯示格式的樣式，可選預設、11（整數）、11.1（浮點數）、11.11（浮點數）、11%（百分比）、11.1%（百分比）、1,111（千分位）和1,111.1（千分位）。更多資料顯示格式請參見資料顯示格式說明。
兩端間距	標籤距離軸線兩端之間的距離，單位%。
標籤展示	軸標籤的展示樣式，包括：軸標籤的數量、標籤的前尾碼內容、標籤的角度值、位移量和標籤展示時的對齊。
文本樣式	軸標籤文本的字型樣式、文字粗細、字型大小和顏色。

刻度標記：瀑布圖的Y軸刻度標記樣式，包括刻度標記的長度值、粗細值和顏色，可單擊表徵圖控制Y軸刻度標記樣式的顯隱。
網格線：瀑布圖的Y軸網格線的樣式，包括網格線的線型樣式、粗細和顏色，可單擊表徵圖控制Y軸網格線的顯隱。
說明
當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

動畫：瀑布圖的動畫效果樣式。

參數	說明
動畫開關	開啟開關，可配置瀑布圖的動畫效果。
動畫效果	動畫的效果類型，系統提供多種常見的動畫效果供您選擇，包括水平生長、垂直生長、縮放漸入和划動進入，僅在開啟動畫開關後可配置。
動畫時間長度	組件動畫效果的期間，單位為ms，僅在開啟動畫開關後可配置。

互動：瀑布圖組件的互動效果樣式。

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

參數	說明
模式	提示框的模式，可選，包括簡潔和通用。
觸發方式	提示框被觸發的方式，可選，包括懸浮和點擊。
顯示位置	提示框顯示的位置樣式，可選，包括上、下、左和右。
標題間距	提示框中標題之間的間距，單位px。
標題文本	提示框中標題文本的樣式，包括字型樣式、文字粗細、字型大小和顏色。
內容顯示	單擊右側的或表徵圖，添加或刪除一個提示框內容顯示系列。單擊或表徵圖配置多個提示框內容顯示系列的排列樣式。單擊表徵圖，即可複製當前選中提示框內容顯示系列配置內容並新增一個同樣配置的提示框內容顯示系列。欄位名：提示框內容的欄位名稱，需要和資料面板中的欄位相匹配。顯示名稱：提示框內容的顯示名稱。尾碼：提示框內容的尾碼。
內容間距	提示框內容文本之間的間距，單位px。
內容文本	提示框中內容文本的樣式，包括文字字型樣式、文字粗細、字型大小和顏色。
彈窗背景	提示框的彈窗背景樣式。背景邊距：提示框彈窗背景在水平和垂直方向的邊距值。背景顏色：提示框的背景顏色。邊框樣式：提示框邊框的樣式，包括邊框線的類型、圓角大小、線寬大小和邊框線的顏色。
軸指標	提示框的軸指示線的樣式，包括軸指示線的類型、粗細值和顏色。單擊表徵圖可開啟或關閉軸指標。說明當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

選中態：當柱子被選中時候的狀態樣式，單擊開關表徵圖表徵圖可開啟或關閉選中態樣式。

參數	說明
觸發方式	柱子被選中觸發的方式，可選，包括懸浮和點擊。
選中方式	選中柱子的方式，可選，包括單選和多選。
柱子顏色	柱子選中狀態下的顏色。
柱子描邊	柱子描邊線的樣式，包括描邊線條的類型、線條的粗細和描邊線的顏色。說明當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

圖例：瀑布圖的圖例樣式。

參數	說明
圖例開關	開啟開關，可配置圖例樣式；關閉開關，無法配置圖例樣式。
圖例位置	圖例相對於組件起始座標的位置，可選頂部居左、頂部置中、頂部居右、底部居左、底部置中、底部居右、左側居頂、左側置中、左側居底、右側居頂、右側置中和右側居底。
文本樣式	圖例文本的字型樣式、文字粗細、字型大小和顏色。
圖表間距	圖例和圖表的水平間距和垂直間距。
分類圖例	分類型圖例的樣式。圖例標記：圖例標記的形狀和尺寸大小。圖例間距：不同分類圖例之間在橫向和縱向的距離。最大寬度：設定圖例的最大寬度，單位為px。允許翻頁：開啟開關，開啟圖例翻頁功能，可配置圖例數量過多需要翻頁顯示時的頁碼樣式和箭頭樣式；關閉開關，圖例內容全部展示在一頁中，無法翻頁顯示。頁碼樣式：翻頁頁碼的樣式，包括頁碼的字型、文字的粗細、字型大小的大小和顏色。箭頭樣式：翻頁樣式內箭頭的尺寸大小、箭頭預設顏色及禁用顏色。

標註：標註樣式說明。
- 輔助線：單擊右側的或表徵圖，添加或刪除一個輔助線系列。單擊或表徵圖配置多個輔助線系列的排列樣式。單擊表徵圖，即可複製當前選中輔助線系列配置內容並新增一個同樣配置的輔助線系列。
  - 類型：設定輔助線的類型，包括橫線和斜線。
  - 資料值：設定輔助線的資料值，包括平均線、中位線、最大值線和最小值線。
  - 線型樣式：設定輔助線的線型樣式，包括輔助線的線型、粗細、長度、間距和顏色。
  - 常值內容：設定輔助線的內容樣式，包括文本、資料顯示開關、旋轉角度、水平和垂直位移和對齊位置。
  - 文本背景：設定輔助線的文本背景，包括背景的填充色、圓角半徑。
  - 文本樣式：設定輔助線的常值內容的文本樣式。
- 輔助框：單擊右側的或表徵圖，添加或刪除一個輔助框系列。單擊或表徵圖配置多個輔助框系列的排列樣式。單擊表徵圖，即可複製當前選中輔助框系列配置內容並新增一個同樣配置的輔助框系列。
  - 端點位置：設定輔助框的起始點橫/縱座標和終止點的橫/縱座標。
  - 背景填充：設定輔助框的背景顏色。
  - 線型樣式：設定輔助框的線型樣式，包括輔助框的線型、粗細、長度、間距和顏色。
  - 地區著色：設定輔助框系列的地區著色顏色值，掃光動畫或柱子背景色開啟時失效。
  - 常值內容：設定輔助框的內容樣式，包括文本、水平和垂直位移、旋轉角度和顯示位置。
  - 文本背景：設定輔助框的文本背景，包括背景的填充色、圓角半徑。
  - 文本樣式：設定輔助框的常值內容的文本樣式。
- 柱子樣式：單擊右側的或表徵圖，添加或刪除一個條件樣式。單擊或表徵圖配置多個條件樣式的排列樣式。單擊表徵圖，即可複製當前選中條件樣式配置並新增一個同樣配置的條件樣式。具體的條件樣式配置說明，請參見條件樹使用說明。
  - 柱子顏色：開啟開關，配置該系列條件樣式中的柱子顏色；關閉開關，無法配置該系列條件下的柱子顏色。
  - 文本標註：當前條件下的文本標註樣式。
    - 常值內容：設定文本標註內容。
    - 位移：設定文本標註的水平和垂直位移，單位為px。
    - 朝向：設定文本標註相對於文本標註點的朝向，包括上、右、下、左。
    - 文本背景：設定文本標註的文本背景，包括背景的填充色、圓角半徑。
    - 文本樣式：設定文字標註的常值內容的文本樣式。
    - 文本連線：設定文本標註的文本連線樣式，包括線型、顏色、粗細和長度。
    - 文本標註點：設定文本標註點的填充顏色、半徑和需要描邊的開關。
      說明
      描邊樣式和連線樣式相同。

資料來源面板

欄位	說明
`x`	用於配置柱子中每個柱子的類目，即x軸的值。
`y`	用於配置柱子中每個柱子的值。

資料項目配置	說明
資料來源	組件的資料來源中通過代碼編輯或可視化編輯展示了組件所包含的資料欄位。也可以修改資料類型，靈活配置組件資料。
資料對應	當您需要自訂圖表欄位配置時，可以在資料對應模組設定不同的欄位對應內容，將這些欄位對應到組件對應的欄位上。無需修改資料來源中的欄位，就可以實現資料的即時匹配。也可以單擊表徵圖對欄位分別樣式配置。
過濾器	開啟過濾器，選擇已建立的資料過濾器或建立資料過濾器，並配置資料過濾器指令碼，實現資料的篩選功能。詳情請參見管理資料過濾器。
資料響應結果	即時展示了組件所使用的資料。當組件資料來源發生變化時，資料響應結果會對應展示最新的資料。如果系統反應延遲，您可以單擊右側的表徵圖，查看資料響應結果，也可以單擊右側的表徵圖，擷取組件的最新資料。您也可以單擊查看樣本，查看當前組件的響應結果樣本。
禁止載入態	勾選複選框，在組件更新和預覽資料看板時，將看不到組件初始化時的載入內容，去勾選則相反。預設為去勾選狀態。
受控模式	勾選複選框，組件初始化狀態下不請求資料，僅通過全域變數或藍圖編輯器配置的方法發起請求資料；去勾選複選框，可以使用自動更新請求資料。預設為去勾選狀態。
自動更新請求	勾選複選框，可以手動輸入輪詢的時間頻次設定動態輪詢。清除後則不會自動更新，需要手動重新整理頁面，或通過藍圖編輯器和全域變數事件來觸發請求更新資料。

進階面板

當資料項目選中時：開啟開關，開啟組件互動功能。當單擊選中某個資料項目時拋出臨時變數，預設拋出資料中的x和y欄位，具體配置請參見組件互動配置。

藍圖互動

單擊頁面左上方的表徵圖，進入藍圖頁面。
在圖層節點頁簽下，添加當前組件至主畫布中。

查看藍圖配置參數。

事件

事件	說明
當瀑布圖介面請求完成時	資料介面請求返回並經過過濾器處理後拋出的事件，同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料來源頁簽的資料響應結果地區。
當資料項目選中時	當單擊瀑布圖的柱子時拋出的事件，同時拋出該柱子對應的資料項目。

動作

動作	說明
匯入瀑布圖介面	按組件繪製格式處理資料後，匯入組件，重新繪製。不需要重新請求服務端資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料來源頁簽的資料響應結果地區。
請求瀑布圖介面	重新請求服務端資料，上遊資料處理節點或圖層節點拋出的資料將作為參數。例如瀑布圖配置了API資料來源為`https://api.test`，傳到請求瀑布圖介面動作的資料為`{ id: '1'}`，則最終請求介面為`https://api.test?id=1`。
高亮	data：需要高亮的資料項目。單個高亮 `{ 'x': '分類一' }` 批量高亮 `[ { 'x': '分類一' }, { 'y': 120 } ]` style：選中樣式。如：fillStyle、stroke、opacity等; 高亮樣式不傳入時，使用預設樣式（配置中選中態的樣式）。參考資料樣本 `{ "data": {}, "style": {} }`
重設選擇項	清空重設組件選擇項資料，不需要參數。
移動	將組件移動到指定位置，參考資料樣本。 `{ // 移動方式。絕對位置：to，相對定位：by。預設值：to。 "positionType": "to", // 指定位置。x座標，y座標。 "attr": { "x": 0, "y": 0 }, // 動畫方式。 "animation": { "enable": false, // 動畫延時，單位ms。 "animationDuration": 1000, // 動畫曲線。可選值為：linear\|easeInOutQuad\|easeInOutExpo。 "animationEasing": "linear" } }`
切換顯隱	切換組件顯示或者隱藏，不需要參數。
顯示	顯示組件，參考資料樣本。 `{ "animationType": "",//動畫方式，可選值：fade，不填無動畫。 "animationDuration": 1000,//動畫延遲，單位ms。 "animationEasing": ""//動畫曲線 }`
隱藏	隱藏組件，參考資料樣本。 `{ "animationType": "",//動畫方式，可選值：fade，不填無動畫。 "animationDuration": 1000,//動畫延遲，單位ms。 "animationEasing": ""//動畫曲線 }`
更新群組件配置	動態更新組件的樣式配置。需要先在組件的樣式面板中，單擊複製配置到剪貼簿，擷取組件配置資料。再根據需要在藍圖編輯器配置頁面，資料處理節點中更改對應樣式的欄位值。