全部產品
Search
文件中心

DataV:輪播圖

更新時間:Feb 27, 2025

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

圖表樣式

輪播圖是媒體組件的一種,支援自訂輪播圖片、輪播動畫效果等,能夠在資料看板中展示多張圖片輪流播放的效果。

樣式面板

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

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

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

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

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

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

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

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

  • 全域樣式

    參數

    說明

    字型

    組件中所有文本的字型。請選擇已安裝於本機中的字型,否則以預設字型顯示。

    字型大小

    組件中所有文本的字型大小,取值範圍為10~100。

  • 動畫

    參數

    說明

    自動輪播

    開啟開關,開啟圖片自動輪播;關閉開關,圖片不輪播。

    停頓

    圖片停留展示的時間,單位為ms。

    速度

    圖片輪播時動畫效果期間,單位為ms。

    特效

    動畫播放的效果,可選:水平滾動垂直滾動淡入淡出馬賽克

  • 圖片

    參數

    說明

    預設圖片

    輪播圖預設顯示的圖片,將本地圖片拖動到虛線框內或者輸入圖片的URL地址。可單擊虛線框內刪除表徵圖刪除當前圖片。

    說明

    當資料面板中url欄位為空白時,使用預設圖片配置項中的圖片。

    填充方式

    圖片的填充方式,可選:展開以充滿容器充滿容器置中

  • 描述:輪播圖中每張圖片的描述樣式,可單擊眼睛表徵圖表徵圖控制描述的顯隱。

    • 背景顏色:描述模組的背景顏色。

      參數

      說明

      顏色樣式

      背景顏色的樣式,可選:漸層單色

      顏色

      背景顏色,僅當顏色樣式單色時有效。

      開始顏色

      背景的開始顏色,請參見顏色選取器說明進行修改,僅當顏色樣式漸層時有效。

      結束顏色

      背景的結束顏色,僅當顏色樣式漸層時有效。

      角度

      開始到結束兩個色彩坡形的方向。

    • 文字顏色:描述文本的顏色。

    • 字型粗細:描述文本的字型粗細。

    • 長度:描述列占組件長度的百分比,單位為%。

    • 高度:描述列占組件高度的百分比,單位為%。

    • 上邊距:描述列距離組件上邊界的距離,單位為px。

    • 左邊距:描述列距離組件左邊界的距離,單位為px。

    • 對齊:描述文本的對齊,可選:向左置中向右

  • 圓點:輪播圖底部的圓點樣式,可單擊眼睛表徵圖表徵圖控制圓點的顯隱。

    參數

    說明

    圓點顏色

    未選中圖片的圓點顏色。

    使用中色彩

    當前頁面的圓點顏色。

資料來源面板

欄位

說明

description

(可選)圖片的描述內容。

url

輪播圖片的URL,與樣式面板中圖片>預設圖片配置項功能相同。如果同時配置,則以url中的內容為準。

說明

此處的圖片需要進行跨網域設定。若不指定訪問協議(如://img.alicdn.com/tps/TB1PH6EPXXXXXXbaFXXXXXXXXXX-4001-2251.png),DataV會按照可視化應用訪問協議去請求圖片。

資料項目配置

說明

資料來源

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

資料對應

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

過濾器

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

資料響應結果

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

禁止載入態

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

受控模式

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

自動更新請求

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

進階面板

開啟開關,開啟組件互動功能。當單擊圖片時,會觸發資料請求,拋出臨時變數,動態載入輪播圖的資料。預設拋出資料中的descriptionurl值,具體配置請參見組件互動配置

藍圖互動

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

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

  3. 查看藍圖配置參數。

    • 事件

      事件

      說明

      當資料介面請求完成時

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

      當點擊圖片時

      當單擊輪播圖的圖片時拋出的事件,同時拋出當前圖片描述和地址對應的資料項目。

    • 動作

      動作

      說明

      請求資料介面

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

      匯入資料介面

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

      開始輪播

      開始輪流播放圖片,參考資料樣本。

         {
           // 圖片在組件資料來源中對應的序號,預設從 0 開始計數
           "index": 0
         }

      停止輪播

      停止播放圖片,無需參數。

      翻到上一頁

      播放小於當前圖片序號的前面一張圖片,無需參數。

      翻到下一頁

      播放大於當前圖片序號的前面一張圖片,無需參數。

      翻到某一頁

      播放某一張圖片,無需參數。

      移動

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

          {
            // 移動方式。絕對位置: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": ""//動畫曲線
      }

      更新群組件配置

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