全部產品
Search
文件中心

DataV:抽獎輪播圖

更新時間:Mar 28, 2026

本文介紹抽獎輪播圖組件的圖表樣式和各配置項的含義。

圖表樣式

抽獎輪播圖用於類比輪播隨機抽取獎品的組件。image

配置面板

image

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

  • 圖表尺寸:包括組件的寬度和高度,單位為px。可單擊鎖定長寬比按鍵表徵圖鎖定組件的寬高比,等比例修改組件的寬高。再次單擊進行解鎖,解鎖後寬高比不受限制。
  • 圖表位置:包括組件的橫座標縱座標,單位為px。橫座標為組件左上方距離頁面左邊界的像素距離,縱座標為組件左上方距離頁面上邊界的像素距離。
  • 旋轉角度:以組件的中心為中心點,進行旋轉,單位為度(°)。
    • 手動輸入角度值,控制組件的旋轉角度。
    • 拖動圓圈旋轉控製圖標表徵圖內的黑點,控制組件的旋轉角度。
    • 單擊左右翻轉表徵圖表徵圖,控制組件左右翻轉樣式。
    • 單擊上下翻轉表徵圖表徵圖,控制組件上下翻轉樣式。
  • 不透明度:取值範圍為0~1。為0時,圖表隱藏;為1時,圖表全部顯示。預設為1
  • 內容:設定抽獎輪播圖組件內容部分的樣式。

    參數

    說明

    獎品

    獎品的樣式。

    • 布局方式:獎品的布局方式,可選水平垂直

    • 運動方向:輪播抽獎時獎品的運動方向,可選

    • 顯示數量:自訂設定輪播抽獎時獎品的顯示數量,預設值為7。

    • 獎品尺寸:設定獎品展示時的寬度和高度值,單位px。

    • 獎品內容:設定展示獎品內容的樣式,單擊右側的加號表徵圖垃圾桶表徵圖表徵圖,添加或刪除一個獎品。 單擊橫柏拉圖標豎柏拉圖標表徵圖配置多個獎品的排列樣式。單擊複製表徵圖表徵圖,即可複製當前選中獎品配置內容並新增一個同樣配置的獎品。

      • 標識:設定獎品的標識數值。

      • 名字:自訂輸入獎品的名稱。

      • 圖片:自訂設定獎品內容的圖片。如果您需要使用遠程伺服器上的圖片,請在上方的輸入框中輸入圖片的URL地址;單擊圖片框內的預覽,即可預覽按鈕圖片的大圖樣式;單擊圖片輸入框下方的虛線框內的更改,更改圖片設計資產詳細功能請參見使用介面功能說明

      說明

      當資料面板中的data欄位中配置了資料,則優先展示資料面板中的內容。

    抽中地區

    設定抽中地區的樣式。

    • 模式:選擇抽中地區的模式,可選偵錯模式正常模式

    • 位置:選擇抽中地區的位置,可選頭部中間尾部,僅在自訂位置關閉開關時可配置。

    • 自訂位置:您可以自訂設定抽中地區的水平位置,單位px。單擊眼睛表徵圖表徵圖控制自訂位置的顯隱。

    • 尺寸:抽中地區的尺寸大小,包括寬度和高度值,單位px。

    • 圓角:設定抽中地區的圓角值,單位px。

    • 填充色:自訂設定抽中地區的填充色。

    • 邊框:設定抽中地區的邊框樣式,包括邊框線的線類型、線的粗細和線的顏色。

    未抽中

    設定未抽中獎品時的樣式。

    • 標識:設定未抽中獎品時的標識數值。

    • 名字:自訂設定未抽中時的展示名稱。

    • 圖片:自訂設定未抽中獎品時的圖片。如果您需要使用遠程伺服器上的圖片,請在上方的輸入框中輸入圖片的URL地址;單擊圖片框內的預覽,即可預覽按鈕圖片的大圖樣式;單擊圖片輸入框下方的虛線框內的更改,更改圖片設計資產詳細功能請參見使用介面功能說明

    說明

    未抽中獎品時,資料拋出值配置。

  • 動畫:設定抽獎輪播圖的動畫樣式。

    參數

    說明

    獎品速度

    設定獎品每一項滾動花費的時間,單位s。

    遞增速度

    設定每次抽中獎品後,遞增速度的值,清空動畫或重新開始動畫,速度會還原。單擊眼睛表徵圖表徵圖控制遞增速度的顯隱。

    中間地區動畫

    設定中間地區動畫的播放方式,可選固定滾動。當選擇滾動時,可以設定動畫的捲動速度

  • 互動:抽獎輪播圖組件按鈕的樣式。

    參數

    說明

    抽獎難度

    設定抽獎的難度選項,可選簡單普通地獄

    說明

    簡單指的是只要抽中地區和獎品有任何重合,就算抽中;普通指的是抽中地區和獎品有三分之一的重合,才算抽中;地獄指的是抽中地區和獎品要有五分之四的重合才算抽中。

    抽獎後暫停

    開啟開關,即可設定每次抽獎後就會暫停抽獎的功能;關閉開關,不暫停抽獎。

資料面板

image

配置欄位說明

欄位

說明

id

獎品的標識ID數值。

title

獎品的名稱。

url

獎品圖片的URL連結地址。

互動面板

image

抽獎:選中啟用,開啟組件互動功能。當抽獎時,會觸發資料請求,拋出回調值,動態載入抽獎輪播圖中的資料。預設拋出資料中的idtitleurl值,具體配置請參見組件回調ID配置

藍圖編輯器互動配置

  1. 在畫布編輯器頁面,按右鍵組件,選擇匯出到藍圖編輯器
  2. 單擊頁面左上方的藍圖表徵圖表徵圖。
  3. 在藍圖編輯器配置頁面,單擊匯入節點欄內的抽獎輪播圖組件,在畫布中可以看到如下圖所示的抽獎輪播圖的藍圖編輯器配置參數。抽獎藍圖參數

    • 事件

      事件

      說明

      當抽獎輪播圖介面描述請求完成時

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

      當抽獎輪播圖介面描述請求失敗時

      資料介面請求失敗時(請求失敗的情況可能是:網路問題或介面報錯等)返回並經過過濾器處理後拋出的事件,同時拋出處理後的JSON格式的資料。具體資料樣本請參見畫布編輯器中組件右側配置面板資料頁簽的資料響應結果地區。

      抽獎

      當抽獎時,拋出抽中資料的事件,同時拋出該事件對應的object類型資料項目,參考資料樣本如下。

      return {
        "id": "",    //獎品標識id
        "title": "", //獎品的名稱
        "url": ""    //獎品的圖片url連結地址
      }
    • 動作

      動作

      說明

      請求抽獎輪播圖介面描述

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

      匯入抽獎輪播圖介面描述

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

      開始動畫

      開始輪播抽獎動畫,不需要參數。

      暫停動畫

      暫停輪播抽獎動畫,不需要參數。

      抽獎

      抽獎,不需要參數。

      恢複動畫

      恢複動畫,不需要參數。

      結束動畫

      結束動畫,不需要參數。

      更新群組件配置

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

      顯示

      顯示組件,參考資料樣本如下。

      return {
        "animationType": "",
        "animationDuration": 1000,
        "animationEasing": "linear"
      };

      隱藏

      隱藏組件,參考資料樣本如下。

      return {
        "animationType": "",
        "animationDuration": 1000,
        "animationEasing": "linear"
      };

      切換顯隱狀態

      切換組件顯示或者隱藏,參考資料樣本如下。

      return {
        "animationIn": {
          "animationType": "",
          "animationDuration": 1000,
          "animationEasing": "linear"
        },
        "animationOut": {
          "animationType": "",
          "animationDuration": 1000,
          "animationEasing": "linear"
        }
      };

      移動

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

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