全部產品
Search

搜尋本產品

    DataV：單張圖片

    文件中心

    DataV：單張圖片

    更新時間：Feb 27, 2025

    本文介紹單張圖片全量選擇時各配置項的含義。

    圖表樣式

    單張圖片是媒體組件的一種，支援自訂圖片的URL地址和跳轉連結，能夠為資料看板和其他組件添加自訂的背景圖，使操作更加智能，資料看板更加美觀。

    樣式面板

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

      • 尺寸：包括組件的寬度和高度，單位為px。

      • 定位：包括組件的橫座標和縱座標，單位為px。橫座標為組件左上方距離頁面左邊界的像素距離，縱座標為組件左上方距離頁面上邊界的像素距離。

      • 旋轉：以組件的中心為中心點，進行旋轉，單位為度（°）。

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

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

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

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

    • 圖片類型：組件可選擇的圖片類型，包括：位元影像和向量圖。

    • 背景圖：當圖片類型配置項選擇位元影像時，您可以自訂背景圖片的內容。如果您需要使用遠程伺服器上的圖片，請在上方的輸入框中輸入圖片的URL地址；單擊圖片框內的預覽，即可預覽按鈕圖片的大圖樣式；單擊圖片輸入框下方的虛線框內的更改，更改圖片設計資產詳細功能請參見使用介面功能說明。如果樣式頁簽和資料來源頁簽都配置了圖片，則優先使用資料來源頁簽中的圖片配置。

      說明

      目前背景圖配置項內支援添加PNG、JPG、GIF、JPEG等格式的位元影像圖片。

    • 向量圖：當圖片類型配置項選擇向量圖時，您可以自訂背景圖片的內容。如果您需要使用遠程伺服器上的圖片，請在上方的輸入框中輸入圖片的URL地址；單擊圖片框內的預覽，即可預覽按鈕圖片的大圖樣式；單擊圖片輸入框下方的虛線框內的更改，更改圖片設計資產詳細功能請參見使用介面功能說明。如果樣式頁簽和資料來源頁簽都配置了圖片，則優先使用資料來源頁簽中的圖片配置。

      說明

      目前向量圖配置項內僅支援添加SVG格式的向量圖片。

    • 填充色：當圖片類型配置項選擇向量圖時，您可以配置組件的內部填充顏色。

    • 圖片重複：背景圖的重複方式，可選不重複，展開滿、水平和垂直重複、水平重複和垂直重複。

    • 圓角：圖片的圓角大小，取值範圍為0~360。數值為0的時候圖片為方形，數值為360時圖片為圓形。

    • 超連結配置：配置後，在預覽或發佈頁面，單擊圖片地區會跳轉至指定的超連結。

      參數

      說明

      超連結

      您可以設定單擊後跳轉頁面的URL，也可以在資料來源面板中的url欄位中進行配置。如果樣式和資料來源面板中都配置了超連結，則優先使用資料來源面板中的配置。

      是否新開視窗

      開啟開關，單擊背景圖可以在新標籤頁開啟背景圖的超連結；關閉開關，直接在當前頁面開啟超連結。

    • 手勢游標：開啟開關，在預覽或發佈頁面當滑鼠移入到單張圖片組件處，滑鼠游標呈現為手型的樣式；關閉開關，滑鼠游標一直保持指標樣式。

    • 濾鏡：開啟開關，調整當前圖片的色相、飽和度、亮度、對比和不透明度。

    資料來源面板

    欄位

    說明

    img

    （可選）設定展示的圖片，會覆蓋掉背景圖或向量圖中的配置。如果該欄位為空白，DataV會讀取配置中的背景圖或向量圖進行展示。

    url

    （可選）設定單擊後跳轉頁面的URL，會覆蓋掉超連結中的配置。如果該欄位為空白，DataV會讀取配置中的超連結進行跳轉。

    資料項目配置

    說明

    資料來源

    組件的資料來源中通過代碼編輯或可視化編輯展示了組件所包含的資料欄位。也可以修改資料類型，靈活配置組件資料。

    資料對應

    當您需要自訂圖表欄位配置時，可以在資料對應模組設定不同的欄位對應內容，將這些欄位對應到組件對應的欄位上。無需修改資料來源中的欄位，就可以實現資料的即時匹配。也可以單擊image表徵圖對欄位分別樣式配置。

    過濾器

    開啟過濾器，選擇已建立的資料過濾器或建立資料過濾器，並配置資料過濾器指令碼，實現資料的篩選功能。詳情請參見管理資料過濾器。

    資料響應結果

    即時展示了組件所使用的資料。當組件資料來源發生變化時，資料響應結果會對應展示最新的資料。如果系統反應延遲，您可以單擊右側的image表徵圖，查看資料響應結果，也可以單擊右側的image表徵圖，擷取組件的最新資料。您也可以單擊查看樣本，查看當前組件的響應結果樣本。

    禁止載入態

    勾選複選框，在組件更新和預覽資料看板時，將看不到組件初始化時的載入內容，去勾選則相反。預設為去勾選狀態。

    受控模式

    勾選複選框，組件初始化狀態下不請求資料，僅通過全域變數或藍圖編輯器配置的方法發起請求資料；去勾選複選框，可以使用自動更新請求資料。預設為去勾選狀態。

    自動更新請求

    勾選複選框，可以手動輸入輪詢的時間頻次設定動態輪詢。清除後則不會自動更新，需要手動重新整理頁面，或通過藍圖編輯器和全域變數事件來觸發請求更新資料。

    進階面板

    互動事件

    說明

    當點擊圖片時

    開啟開關，開啟關聯全域變數功能。當單擊圖片時，會觸發資料請求，拋出臨時變數，動態載入圖片的資料。預設拋出資料中的img和url值，具體配置請參見組件互動配置。

    當滑鼠移入時

    開啟開關，開啟關聯全域變數功能。當滑鼠移入到圖片時，會觸發資料請求，拋出臨時變數，動態載入圖片的資料。預設拋出資料中的img和url值，具體配置請參見組件互動配置。

    當滑鼠移出時

    開啟開關，開啟關聯全域變數功能。當滑鼠移出圖片時，會觸發資料請求，拋出臨時變數，動態載入圖片的資料。預設拋出資料中的img和url值，具體配置請參見組件互動配置。

    藍圖互動

    1. 單擊頁面左上方的image表徵圖，進入藍圖頁面。

    2. 在圖層節點頁簽下，添加當前組件至主畫布中。

    3. 查看藍圖配置參數。

      • 事件

        事件

        說明

        當資料介面請求完成時

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

        當點擊圖片時

        當單擊單張圖片組件的圖片時拋出的事件，同時拋出該圖片對應的資料項目，參考資料樣本。

        {
  "img": "https://cdn-upload.datav.aliyun.com/upload/download/1665303038655-qcqm05Nw.jpeg",
  "url": "https://www.aliyun.com"
}

        當滑鼠移入時

        當滑鼠移入到圖片時拋出的事件，同時拋出該圖片對應的資料項目，參考資料樣本。

        {
  "img": "https://cdn-upload.datav.aliyun.com/upload/download/1665303038655-qcqm05Nw.jpeg",
  "url": "https://www.aliyun.com"
}

        當滑鼠移出時

        當滑鼠移出圖片時拋出的事件，同時拋出該圖片對應的資料項目，參考資料樣本。

        {
  "img": "https://cdn-upload.datav.aliyun.com/upload/download/1665303038655-qcqm05Nw.jpeg",
  "url": "https://www.aliyun.com"
}

      • 動作

        動作

        說明

        匯入資料介面

        按組件繪製格式處理資料後，匯入組件，重新繪製。不需要重新請求服務端資料，參考資料樣本。

        [
  {
    "img": "https://cdn-upload.datav.aliyun.com/upload/download/1665303038655-qcqm05Nw.jpeg",
    "url": "https://www.aliyun.com"
  }
]

        請求資料介面

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

        重新整理

        重新整理圖片，不需要參數。

        移動

        將組件移動到指定位置，參考資料樣本。

            {
      // 移動方式。絕對位置：to，相對定位：by。預設值：to。
        "positionType": "to",
      // 指定位置。x座標，y座標。
      "attr": {
        "x": 0,
        "y": 0
      },
      // 動畫方式。
      "animation": {
        "enable": false,
        // 動畫延時。
        "animationDuration": 1000,
        // 動畫曲線。可選值為：linear|easeInOutQuad|easeInOutExpo。
        "animationEasing": "linear"
      }
    }

        切換顯隱

        切換組件顯示或隱藏，不需要參數。

        顯示

        顯示組件，參考資料樣本。

        {
  "animationType": "",//動畫方式，可選值：fade，不填無動畫。
  "animationDuration": 1000,//動畫延遲，單位ms。
  "animationEasing": ""//動畫曲線
}

        隱藏

        隱藏組件，參考資料樣本。

        {
  "animationType": "",//動畫方式，可選值：fade，不填無動畫。
  "animationDuration": 1000,//動畫延遲，單位ms。
  "animationEasing": ""//動畫曲線
}

        更新群組件配置

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