二維表徵圖層（v3.x版本）組件配置項詳解-DataV-阿里雲

本文介紹二維表徵圖層各配置項的含義。

圖表樣式

二維表徵圖層是3D平面地圖（v3.x版本）的子組件，支援獨立的樣式、資料和互動配置，包括表徵圖的形狀、大小和顏色等，能夠以二維表徵圖的形式定位3D平面地圖中的地理位置。

樣式模板

搜尋配置：單擊樣式面板右上方的搜尋配置項表徵圖，可在搜尋配置面板中輸入您需要搜尋的配置項名稱，快速定位到該配置項，系統支援模糊比對。詳情請參見搜尋配置項。
通用：設定二維表徵圖層的通用配置項。
參數
說明
不透明度
二維表徵圖層的不透明度，範圍為0~100，單位%。數值越大二維表徵圖層越不透明。
圖形：設定二維表徵圖層的圖形配置項。
- 表徵圖形狀：設定二維表徵圖層在3D平面地圖上顯示的表徵圖形狀，請參見形狀映射器使用說明，配置不同表徵圖的形狀映射樣式。
- 表徵圖尺寸：二維表徵圖層表徵圖的尺寸樣式參數。
  參數
  說明
  寬度
  二維表徵圖層表徵圖的寬度，範圍為0~400，單位px。
  高度
  二維表徵圖層表徵圖的高度，範圍為0~400，單位px。

標籤：設定二維表徵圖層內標籤的樣式參數。

顯示標籤：開啟開關，顯示二維表徵圖層標籤；關閉開關，不顯示二維表徵圖層標籤。
顯示方式：設定二維表徵圖層標籤的顯示方式，包括全選和點擊兩種方式。

內容樣式：設定標籤內容的樣式。

參數	說明
每行樣式	單擊每行樣式右側的或表徵圖，添加或刪除一個每行內容樣式。單擊或表徵圖配置多個每行內容樣式的相片順序。單擊表徵圖，即可複製當前選中內容樣式配置內容並新增一個同樣配置的每行內容。列欄位：行內容的欄位名稱，需要和資料面板中的欄位相匹配。欄位樣式：設定列欄位樣式，包括欄位的字型樣式、字型大小大小、顏色和粗細值。欄位首碼：設定欄位首碼的具體內容、內容間隔值、字型、字型大小大小、顏色和粗細值。單擊欄位首碼左側的表徵圖，可控制欄位首碼樣式的顯隱。欄位尾碼：設定欄位尾碼的具體內容、內容間隔值、字型、字型大小大小、顏色和粗細值。單擊欄位尾碼左側的表徵圖，可控制欄位尾碼樣式的顯隱。
欄位寬度	設定欄位的寬度，包括欄位的適應類型和欄位的最大寬度。其中欄位的適應類型包括自適應和固定寬度
行高比例	標籤的行高比例值，取值範圍為1~2。
內容描邊	設定標籤內容邊的顏色和粗細值，粗細值的取值範圍為0~5。單擊內容描邊左側的表徵圖，可控制內容描邊樣式的顯隱。
內容陰影	設定標籤內容的陰影，包括陰影的顏色、粗細值、X方向的位移量和Y方向的位移量，取值範圍均為0~10，單位為px。單擊內容陰影左側的表徵圖，可控制內容陰影樣式的顯隱。
背景樣式	設定標籤內容的背景樣式。單擊背景樣式左側的表徵圖，可控制背景樣式樣式的顯隱。背景類型：設定標籤內容的背景類型，包括向量和圖片。當背景類型選擇向量時，按照如下參數設定背景樣式。背景顏色：設定標籤內容的背景顏色。邊框樣式：設定標籤內容邊框的樣式，包括邊框的線類型，線寬的值和顏色。邊框圓角：設定標籤內容邊框的圓角在四個方向的值，單位px。內容邊距：設定標籤內容中的內容距離上下左右四個方向的邊距值。當背景類型選擇圖片時，按照如下參數設定背景樣式。圖片模板：設定標籤內容背景的圖片模板。不透明度：設定背景圖片的不透明度，範圍為0~100。內容邊距：設定標籤內容中的內容距離上下左右四個方向的邊距值。

互動：二維表徵圖層互動參數說明。
- 圖形互動：開啟圖形互動左側的表徵圖，可控制圖形互動樣式的顯隱。
- 支援多選：開啟開關，支援多選互動效果；關閉開關，關閉多選互動效果。
- 點擊樣式：開啟點擊樣式左側的表徵圖，可控制點擊樣式樣式的顯隱。
  參數
  說明
  線框粗細
  設定單擊表徵圖時，互動線框的粗細值，範圍0~5，單位px。
  線框顏色
  設定單擊表徵圖時，互動線框的顏色。
條件：條件樣式說明。
條件樣式：單擊右側的或表徵圖，添加或刪除一個條件樣式。單擊或表徵圖配置多個條件樣式的排列樣式。單擊表徵圖，即可複製當前選中條件樣式配置內容並新增一個同樣配置的條件樣式。具體樣式配置說明，請參見條件樹使用說明。
圖形：設定該條件下二維表徵圖層內的圖形樣式。單擊圖形左側的表徵圖，可控制該條件下二維表徵圖層內對應圖形的顯隱。
- 表徵圖形狀：設定該條件下二維表徵圖層的表徵圖形狀。單擊左側表徵圖，可控製圖標形狀的開啟或關閉。
- 表徵圖尺寸：設定該條件下二維表徵圖層表徵圖的尺寸，包括表徵圖的寬度和高度，取值範圍均為0~400，單位px。單擊左側表徵圖，可控制表徵圖尺寸按鈕的顯隱。

資料來源面板

欄位	說明
`lng`	二維表徵圖層的經度。
`lat`	二維表徵圖層的緯度。
`name`	二維表徵圖層的名稱。
`id`	二維表徵圖層的唯一識別碼。
`iconUrl`	二維表徵圖層的自訂表徵圖路徑。
`iconField`	二維表徵圖層的形狀映射欄位。

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

進階面板

開啟開關，開啟組件互動功能。單擊某個點時，觸發資料請求，拋出臨時變數，實現在單擊點時，動態載入不同點的資料。預設拋出所單擊地區的lng和lat值，具體配置請參見組件互動配置。

藍圖互動

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

查看藍圖配置參數。

事件

事件	說明
當資料介面請求完成時	資料介面請求返回並經過過濾器處理後拋出的事件，同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料來源頁簽的資料響應結果地區。
當點擊點時	當單擊二維表徵圖層內某一個點時拋出資料。

動作

動作	說明
請求資料介面	重新請求服務端資料，上遊資料處理節點或圖層節點拋出的資料將作為參數。例如二維表徵圖層配置了API資料來源為`https://api.test`，傳到請求資料介面動作的資料為`{ id: '1'}`，則最終請求介面為`https://api.test?id=1`。
匯入資料介面	按組件繪製格式處理資料後，匯入組件，重新繪製。不需要重新請求服務端資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料來源頁簽的資料響應結果地區。
切換顯隱	切換組件顯示或者隱藏，不需要參數。
顯示	顯示組件，參考資料樣本。 `{ "animationType": "",//動畫方式，可選值：fade，不填無動畫。 "animationDuration": 1000,//動畫延遲，單位ms。 "animationEasing": ""//動畫曲線 }`
隱藏	隱藏組件，參考資料樣本。 `{ "animationType": "",//動畫方式，可選值：fade，不填無動畫。 "animationDuration": 1000,//動畫延遲，單位ms。 "animationEasing": ""//動畫曲線 }`
更新群組件配置	動態更新組件的樣式配置。需要先在組件的樣式面板中，單擊複製配置到剪貼簿，擷取組件配置資料。再根據需要在藍圖編輯器配置頁面的資料處理節點中更改對應樣式的欄位值。

參數	說明
不透明度	二維表徵圖層的不透明度，範圍為0~100，單位%。數值越大二維表徵圖層越不透明。

參數	說明
寬度	二維表徵圖層表徵圖的寬度，範圍為0~400，單位px。
高度	二維表徵圖層表徵圖的高度，範圍為0~400，單位px。

參數	說明
線框粗細	設定單擊表徵圖時，互動線框的粗細值，範圍0~5，單位px。
線框顏色	設定單擊表徵圖時，互動線框的顏色。