反饋已提交

網絡繁忙

FVS頁面API

適用場景:安裝了「FVS企業戰情室編輯模式」插件的使用者,可參考本文了解 FVS 範本的相關API。


版本

報表伺服器版本插件版本功能變動
11.0V1.0.0最低版本要求
11.0.16V1.18.0新增關閉頁面全螢幕API exitFullscreen


this

方法this獲取當前的組件物件,獲取後可以使用組件的方法和屬性
     參數--
   傳回值object 當前組件物件
     範例

範例1:獲取當前元件組件的實際值

this.getValue();

範例2:設定當前元件不可見

this.setVisible(false);

範例3:清空當前元件的值

this.reset();


  應用範例

-

    行動端支援行動端

getAllWidgets

方法getAllWidgets()獲取當前頁面中所有組件資訊
     參數--
   傳回值{ [key: string,value:object] }key 為組件名,value 為組件物件
     範例

查看當前頁面中所有的組件資訊:

duchamp.getAllWidgets();


  應用範例

瀏覽器 F12 開發者工具查看 FVS 企業戰情室範本「頁面1」中所有的組件資訊:

Snag_2e1342ab.png

   行動端支援行動端

getWidgetByName

方法getWidgetByName(name)獲取當前頁面中的某個組件
     參數name: string組件名稱,字串
   傳回值object 組件物件
     範例

注:代碼新增在「初始化後」事件中時,建議新增一個延遲函式,否則可能會因為報表物件沒有完全建立而發生錯誤例如開啓表格跑馬燈:

setTimeout(() => {
        duchamp.getWidgetByName("表格").startMarquee()        
}, 500)


  應用範例

獲取表格組件,並開啓表格跑馬燈。詳情請參見:FVS表格跑馬燈

    行動端支援行動端

switchStory

方法switchStory(name)跳轉到指定頁面
     參數name,{para:"para"}指定頁面的名稱,字串
   傳回值--
     範例

範例1:點選跳轉到「頁面4」

duchamp.switchStory("頁面4");

範例2:點選跳轉到「頁面4」並傳參(僅支援 V1.16.0 及之後版本)

duchamp.switchStory("頁面4",{area:"華北"});

注:傳遞多個參數時,寫法如下

duchamp.switchStory("頁面名稱",{a:"參數a",b:"參數b"});


  應用範例

JS實現FVS切換分頁

    行動端支援行動端

nextStory

方法nextStory()跳轉到下一頁
     參數{para:"para"}參數名稱:參數值
   傳回值--
     範例

範例1:跳轉到下一頁

duchamp.nextStory();

範例2:跳轉到下一頁並傳參(僅支援 V1.16.0 及之後版本)

duchamp.nextStory({area:"華北"});

注:傳遞多個參數時,寫法如下

duchamp.nextStory({a:"參數a",b:"參數b"});


  應用範例

JS實現FVS切換分頁

    行動端支援行動端

previousStory

方法previousStory()跳轉到上一頁
     參數{para:"para"}參數名稱:參數值
   傳回值--
     範例

範例1:跳轉到上一頁

duchamp.previousStory();

範例2:跳轉到上一頁並傳參(僅支援 V1.16.0 及之後版本)

duchamp.previousStory({area:"華北"});

注:傳遞多個參數時,寫法如下

duchamp.previousStory({a:"參數a",b:"參數b"});


  應用範例

JS實現FVS切換分頁

    行動端支援行動端

refresh

方法refresh()觸發組件重新整理
     參數{para:"para"}參數名稱:參數值
   傳回值--
     範例

範例1:觸發「組件1」重新整理

duchamp.getWidgetByName("組件1").refresh();

範例2:觸發「柱形圖」組件重新整理並將地區華北作為參數傳遞給柱形圖

duchamp.getWidgetByName("柱形圖").refresh({area:"華北"});

注:給同一組件傳多個參數時,寫法如下

duchamp.getWidgetByName("組件").refresh({a:"參數值",b:"參數值"});


  應用範例

點選標題組件,觸發「柱形圖」組件重新整理並將地區華北作為參數傳遞給柱形圖

點選可下載範本:refresh刷新元件.fvs

    行動端支援行動端

trigger

方法trigger()

觸發組件點選事件

注:不支援三維組件和元件組件

     參數-

-

   傳回值--
     範例

觸發「組件1」的所有點選事件

duchamp.getWidgetByName("組件1").trigger();


  應用範例

-

    行動端支援行動端

requestFullscreen

方法requestFullscreen()觸發頁面全螢幕
     參數--
   傳回值--
     範例

範例:給標題組件新增點選 JavaScript 事件,觸發頁面全螢幕

duchamp.requestFullscreen();


  應用範例

-

    行動端不支援行動端

exitFullscreen

方法exitFullscreen()

關閉頁面全螢幕

注:僅針對 requestFullscreen API觸發的全螢幕,若使用按鍵 F11 觸發全螢幕,則該API無效

     參數--
   傳回值--
     範例

範例:給標題組件新增點選 JavaScript 事件,關閉頁面全螢幕

duchamp.exitFullscreen();


  應用範例

-

    行動端不支援行動端

reload

方法reload()觸發範本整體重新整理
     參數--
   傳回值--
     範例

每兩秒重新整理一次頁面

setInterval(() => {
    duchamp.reload();
  }, 2 * 1000);


  應用範例

V1.7.2 版本之前的插件,只能透過範本的「範本>頁面載入結束事件」寫 JavaScript 代碼實現

V1.7.2 及之後版本,可透過「範本定時重新整理」功能設定,詳情請參見:FVS範本定時重新整理

    行動端支援行動端

setPageButtonDisplayPolicy

方法setPageButtonDisplayPolicy()設定多分頁範本左下角切換分頁按鈕是否顯示
     參數always/hover/never

切換按鈕的三種狀態(預設為 always):

  • always:永遠顯示

  • hover:滑鼠懸浮時顯示

  • never:從不顯示

   傳回值--
     範例

範例1:設定切換按鈕永遠顯示

duchamp.setPageButtonDisplayPolicy("always");

範例2:設定切換按鈕隱藏,滑鼠懸浮時顯示

duchamp.setPageButtonDisplayPolicy("hover");

範例3:設定切換按鈕從不顯示

duchamp.setPageButtonDisplayPolicy("never"); 


  應用範例-
    行動端不支援行動端


附件列表


主題: 二次開發
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉