玉玨圖組件配置項詳解-DataV-阿里雲

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

圖表樣式

玉玨圖使用旋轉柱型條來展示分類資料。玉玨圖可以對比分類資料的數值大小，當分類情況過多時，柱狀圖的文本為了排布合理，需要進行旋轉，不利於閱讀，相比於縱向柱狀圖，玉玨圖更適用於此類分類較多的情境。

樣式面板

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

圖形

參數	說明
圖表邊距	單擊表徵圖，控製圖表邊距的顯隱。開啟開關後，可配置玉玨圖地區與組件上下左右四個邊界之間的距離，單位預設px。
最大弧度	玉玨圖弧形柱子的最大弧度值，取值範圍為0~360，單位為度（°）。
弧形形狀	玉玨圖內弧形柱子的弧形樣式，可選直角和圓角。
弧形寬度	玉玨圖弧形柱子的弧型寬度值，單位px。
弧形顏色	弧形柱圖的顏色，請參見顏色映射器使用說明，配置不同弧形柱圖的映射顏色樣式。
背景顏色	弧形柱圖的背景顏色。
弧形描邊	弧形柱圖描邊的樣式，包括弧形柱圖描邊線的類型、粗細和顏色。說明當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。
弧形發光	弧形的發光樣式，單擊表徵圖，控制弧形發光配置項的顯隱。發光顏色：包括跟隨弧形開關和不透明度。當關閉跟隨弧形開關後，可以單獨設定發光顏色。模糊係數：設定弧形發光的模糊係數，範圍0~50，數值越大弧形間的發光範圍越模糊。
弧形標籤	弧形柱圖的標籤樣式，單擊表徵圖，控制弧形標籤配置項的顯隱。標籤欄位：標籤的內容需要和資料面板中欄位的內容對應，預設擷取t欄位內容。數值格式：設定標籤的數值格式，可選預設、11（整數）、11.1（浮點數）、11.11（浮點數）、11%（百分比）、11.1%（百分比）、1,111（千分位）和1,111.1（千分位）。更多資料顯示格式請參見資料顯示格式說明，僅在標籤欄位選擇`t`時顯示。前尾碼：設定柱子標籤的前尾碼內容。相對位移：弧形標籤相對組件在垂直和水平方向的位移量，單位為px。文本樣式：弧形標籤的文本樣式，包括文本的字型樣式、文字粗細、字型大小和顏色。文本描邊：弧形標籤的文本描邊樣式，包括描邊線的粗細值和顏色。
貼圖	柱子的貼圖樣式，單擊表徵圖，控制貼圖配置項的顯隱。說明貼圖背景不支援漸層色。類型：貼圖的類型，包括點形、線形和正方形。填充樣式：設定貼圖的填充樣式。請參見顏色選取器說明，配置貼圖的顏色樣式。描邊樣式：設定貼圖的描邊樣式。請參見顏色選取器說明，配置貼圖的顏色樣式。當類型選擇為點形或正方形時顯示。額外樣式：貼圖的其他樣式，包括貼圖的圖形尺寸、圖形間距、線間距、旋轉角度和是否交錯開關。

座標：組件半徑軸的樣式。

半徑軸顯示：開啟開關，組件內半徑軸樣式顯示可見；關閉開關，組件內半徑軸樣式不可見。
資料類型：半徑軸的資料類型，包括類目型和時間型。
半徑範圍：弧形柱條的內外半徑軸的值，單位%。
軸線：玉玨圖的半徑軸軸線樣式，包括線的類型、線的粗細和線的樣式，可單擊表徵圖控制半徑軸軸線樣式的顯隱。
說明
當線的類型選擇虛線或點線時，還可以配置線的間斷長度值和每一個間斷線之間的距離。

軸標題：玉玨圖的半徑軸軸標題樣式，可單擊開關表徵圖表徵圖控制半徑軸軸標題的顯隱。

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

軸標籤：玉玨圖的半徑軸軸標籤樣式，可單擊開關表徵圖表徵圖控制半徑軸軸標籤的顯隱。

參數	說明
標籤展示	標籤的展示樣式，包括：軸標籤的前尾碼內容、標籤的角度值、位移量和對齊。
文本樣式	軸標籤文本的字型樣式、文字粗細、字型大小和顏色。

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

動畫：當前圖表的動畫效果樣式。
- 入場動畫：設定當前圖表的入場動畫樣式，單擊表徵圖控制入場動畫的顯隱。
  - 動畫效果：動畫的效果類型，系統提供多種常見的動畫效果供您選擇，包括縮放漸入、划動進入、水平生長和垂直生長。
  - 動畫時間長度：組件動畫效果的期間，單位為ms。
- 掃光動畫：設定當前圖表的掃光動畫樣式，單擊表徵圖控制掃光動畫的顯隱。
  重要
  當前動畫開啟後將導致選中態等互動功能失效。
  - 高光樣式：設定掃光動畫的高光高度和高光強度。
  - 動效：設定掃光動畫的動畫時間長度和間隔時間，單位為ms。

互動：玉玨圖組件的互動效果樣式。

輪播效果：開啟輪播後，將應用提示框配置，且提示框不再通過互動觸發。單擊表徵圖控制輪播效果的顯隱。

提示框：在預覽或發佈頁面，滑鼠懸浮或單擊弧形柱條時出現的提示框的樣式，單擊開關表徵圖表徵圖可開啟或關閉提示框。以通用模式為例。

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

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

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

圖例：玉玨圖的圖例樣式。

參數	說明
圖例開關	開啟開關，可配置圖例樣式；關閉開關，無法配置圖例樣式。
圖例位置	圖例相對於組件起始座標的位置，可選頂部居左、頂部置中、頂部居右、底部居左、底部置中、底部居右、左側居頂、左側置中、左側居底、右側居頂、右側置中和右側居底。
文本樣式	圖例文本的字型樣式、文字粗細、字型大小和顏色。
圖表間距	設定圖例和圖表的水平間距和垂直間距，單位px。
分類圖例	分類型圖例的樣式。只有當組件樣式面板中的圖形弧形顏色映射類型配置為名詞分類時，圖例才展示成分類型圖例。圖例標記：圖例標記的形狀和尺寸大小。圖例間距：不同分類圖例之間的水平間距和內間距。最大寬度：不同分類圖例之間的最大寬度。允許翻頁：開啟開關，開啟圖例翻頁功能，可配置圖例數量過多需要翻頁顯示時的頁碼樣式和箭頭樣式；關閉開關，圖例內容全部展示在一頁中，無法翻頁顯示。頁碼樣式：翻頁頁碼的樣式，包括頁碼的字型、文字的粗細、字型大小的大小和顏色。箭頭樣式：翻頁樣式內箭頭的尺寸大小、箭頭預設顏色及禁用顏色。
連續圖例	連續圖例的樣式。只有當組件樣式面板中的圖形弧形顏色映射類型配置為數值連續或數值分區時，圖例才展示成連續型圖例。滑軌樣式類型：圖例滑動軌道的類型，包括矩形和三角形。長度：圖例滑動軌道的長度值。高度：圖例滑動軌道的高度值。背景色：圖例滑動軌道的背景顏色。滑塊樣式：圖例中滑軌上的滑塊樣式。最小值：滑塊的最小值，支援自訂輸入，也支援系統選擇自動，取資料中的最小值。最大值：滑塊的最大值，支援自訂輸入，也支援系統選擇自動，取資料中的最大值。尺寸：滑塊的尺寸大小。顏色：滑塊的顏色。標註樣式：圖例上文字標註的樣式。對齊：圖例文字標註相對於滑軌的對齊，包括頂端對齊、置中對齊和底端對齊。間距：圖例文字標註與滑軌的距離。

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

資料來源面板

欄位	說明
`r`	玉玨圖中每個弧形的類目。
`t`	玉玨圖中每個弧形的數值。
`colorField`	（可選）顏色映射欄位，用於設定每個弧形的各種顏色和資料數值之間的映射配置樣式。

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

進階面板

互動	說明
當資料項目選中時	開啟開關，開啟組件互動功能。玉玨圖組件擁有互動配置，當單擊選中某個資料項目時拋出臨時變數，預設拋出資料中的`r`和`t`欄位。具體配置請參見組件互動配置。
當圖例被點擊時	開啟開關，開啟組件互動功能。玉玨圖組件擁有互動配置，當單擊某個圖例時拋出回調值，預設拋出資料中的`value`和`checked`欄位。具體配置請參見組件互動配置。

藍圖互動

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

查看藍圖配置參數。

事件

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

動作

動作	說明
匯入玉玨圖介面	按組件繪製格式處理資料後，匯入組件，重新繪製。不需要重新請求服務端資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料來源頁簽的資料響應結果地區。
請求玉玨圖介面	重新請求服務端資料，上遊資料處理節點或圖層節點拋出的資料將作為參數。例如玉玨圖配置了API資料來源為`https://api.test`，傳到請求玉玨圖介面動作的資料為`{ id: '1'}`，則最終請求介面為`https://api.test?id=1`。
高亮	data：需要高亮的資料項目。單個高亮 `{ r: '分類一', t: 10 }` 批量高亮 `[ { r: '分類一', t: 10 }, { r: '分類二', t: 20 } ]` 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": ""//動畫曲線 }`
更新群組件配置	動態更新組件的樣式配置。需要先在組件的樣式面板中，單擊複製配置到剪貼簿，擷取組件配置資料。再根據需要在藍圖編輯器配置頁面的資料處理節點中更改對應樣式的欄位值。