一、概述
10.0中跑馬燈場景的實現,需要使用者編寫大段代碼來實現,還可能存在很多兼容性問題。
11.0開放了跑馬燈場景的API,兼容性好,版本更新對代碼影響小。
二、API說明
1
startMarquee
注1:用以下API實現的跑馬燈效果,不支援【決策報表内報表塊刷新插件】實現刷新。
方法 | startMarquee(opt) | 開啓跑馬燈效果。 |
---|
參數 | opt: { offset: number; interval: number; stopOnHover: boolean; to: string} | 滾動效果屬性,json 格式。 offset:每次滾動的距離,預設為 5px,單位為 px。 interval:間隔時長,預設為 0.1s,單位為 s。 stopOnHover:滑鼠懸停時是否暫停,預設為 true: true:暫停。 false:不暫停。 to:滾動的方向,支援向上和向左,預設向上: 'top':向上滾動。 'left':向左滾動。 |
---|
傳回值 | void |
|
---|
範例 | 範例1:若獲取到的報表塊物件定義為 report,實現預設的跑馬燈效果(每 0.1s 滾動 5 px,滑鼠懸停時暫停)。
report.startMarquee();
範例2:普通報表中實現預設的跑馬燈效果。 _g().startMarquee();
範例3:決策報表中給 report0 報表塊添加預設的跑馬燈效果。 _g().getWidgetByName('report0').startMarquee();
注:代碼添加在【初始化後】事件中時,建議添加一個延遲函式,否則可能會因為報表塊物件沒有完全創建而發生錯誤。範例如下: setTimeout(function(){ _g().getWidgetByName('report0').startMarquee(); }, 500);
範例4:普通報表中實現每 0.3s 向左滾動 2 px,滑鼠懸停時不暫停。 report.startMarquee({ offset: 2, interval: 0.3, stopOnHover: false, to:'left' });
範例5:決策報表中 report0 報表塊實現每 0.3s 向左滾動 2 px,滑鼠懸停時不暫停。 setTimeout(function() { _g().getWidgetByName('report0').startMarquee({ offset: 2, interval: 0.3, stopOnHover: false, to:'left' }); }, 500);
|
---|
應用範例 | 報表塊實現預設的跑馬燈效果,滑鼠懸浮時停止滾動: 點擊可下載範本:開啟跑馬燈.frm。

|
---|
行動端 | 不支援行動端。 |
---|
2
stopMarquee
方法 | stopMarquee() | 關閉跑馬燈效果。 |
---|
參數 | - | - |
---|
傳回值 | void |
|
---|
範例 | 範例1:若獲取到的報表塊物件定義為 report,關閉透過 startMarquee() 設定的跑馬燈效果。report.stopMarquee();
範例2:普通報表中關閉透過 startMarquee() 設定的跑馬燈效果。 _g().stopMarquee();
範例3:決策報表中關閉 report0 報表塊的跑馬燈效果。 _g().getWidgetByName('report0').stopMarquee();
|
---|
應用範例 | 報表塊實現跑馬燈效果,點擊【關閉】按鈕關閉跑馬燈效果: 點擊可下載範本:關閉跑馬燈.frm。

|
---|
行動端 | 不支援行動端。 |
---|