1. 概述
1.1 版本
報表伺服器版本 | 插件版本 |
---|---|
11.0 | V1.4.3 |
1.2 應用場景
報表預設捲軸效果,在凍結等特別模式中顯得十分臃腫。效果如下圖所示:
安裝該插件後,捲軸樣式被統一為灰色的長圓角矩形,並且會跟隨滑鼠滾輪捲動,會在閒置時自動隱藏,使介面變得簡潔。效果如下圖所示:
2. 插件簡介
2.1 安裝插件
點選下載插件:自訂捲軸
設計器插件安裝方法參照 設計器插件管理
伺服器安裝插件方法參照 伺服器插件管理
2.2 功能說明
插件安裝成功後,無需配置或重啟,新的捲軸樣式立馬生效,只要開啟可以顯示捲軸的範本就能看到。
插件安裝後,直接開啟內建範本:%FR_HOME%\webroot\WEB-INF\reportlets\demo\NewbieGuide\行式報表.cpt
可以發現捲軸的樣式變了,且滑鼠靜止一會後,捲軸會自動隱藏。
2.3 注意事項
1)插件支援普通報表、決策報表的報表塊。但不支援決策報表整體,也就是 body 。
2)插件支援分頁預覽、填報預覽、資料分析預覽。不支援行動端。
3)插件安裝後,新的捲軸是作用於伺服器下所有範本的,如果想要給範本單獨自訂捲軸樣式,可以參考第三章用插件的 API API,新增 JavaScript 事件來實現。
3. 自訂捲軸樣式
3.1 API說明
插件也提供了樣式配置 API API,如果您對新捲軸樣式還是不太滿意,可以使用API自訂這個插件捲軸的樣式。API 文檔如下:
注:不支援在 FVS 範本 和 新版決策報表 中使用。
屬性 | 屬性值類型 | 預設值 | 說明 |
---|---|---|---|
distance | string | "1px" | 捲軸和視窗邊框之間的距離 |
size | string | "10px" | 捲軸的寬度大小 |
alwaysVisible | boolean | false | 捲軸是否總是顯示,設定成 false 的時候,滑鼠停止行動後會逐漸消失 |
color | string | "#000" | 捲軸的顏色 |
axis | string | "y" | 使用橫向捲軸或者縱向捲軸,取值範圍("x";"y";"both");暫時不支援自訂,使用報表的預設屬性 |
borderRadius | string | "7px" | 捲軸的圓角設定 |
disableFadeOut | boolean | false | 當滑鼠懸停在頁面上的時候,捲軸是否消失 |
opacity | number | 0.4 | 設定捲軸的透明度,取值範圍(0.0~1.0); |
positionX | string | "bottom" | 設定橫向捲軸在頁面中的位置,取值範圍("top", "bottom") |
positionY | string | "right" | 設定縱向捲軸在頁面中的位置,取值範圍("left", "right") |
startX | string | "left" | 設定橫向捲軸初始化的時候頁面捲動位置,取值範圍("left", "right") |
startY | string | "top" | 設定縱向捲軸初始化的時候頁面捲動位置,取值範圍("top", "bottom") |
wheelStep | number | 60 | 滑鼠滾輪滾輪捲動一次的距離 |
3.2 自訂範例
1)這個API是插件提供的,所以想要自訂捲軸樣式,一定要安裝這個插件。
2)插件安裝後,直接開啟內建範本:%FR_HOME%\webroot\WEB-INF\reportlets\demo\NewbieGuide\行式報表.cpt
3)在分頁預覽設定頁面新增一個載入結束事件,如下圖所示:
注1:若範本最終為「資料分析」、「填報預覽」兩種預覽方式,請新增「載入起始」事件。
注2:若範本為決策報表,需要對報表塊新增「初始化後」事件。
JavaScript 程式碼如下:
4)儲存範本,分頁預覽的效果如下圖所示: