FVS Template Loading Effect

  • Last update:July 18, 2024
  • Overview

    This document applies to users who have installed the FineVis Data Visualization plugin to learn plugin functions.

    Version

    Report Server Version
    Plugin VersionFunctional Change

    11.0.16

    V2.0.0

    Added the Loading Effect function to the FVS template setting page. You can customize the page loading background color.

    11.0.22

    V2.7.1

    Allowed you to set the template loading effect and component loading effect respectively.

    Added styles such as image and video to the loading effect.

    11.0.22

    V2.8.1

    Made the image source of the loading effect support more settings, including saturation, brightness, and contrast.

    Application Scenario

    The screen becomes white during the FVS template loading or switching due to performance or network issues. In this case, you want to customize the loading effect.

    You want to set the opening animation of the template loading.

    Since the component loading takes too much time, you want to customize the component loading effect.

    Function Description

    You can set the template loading and component loading effects respectively under Template > FVS Template Setting > Loading Effect.

    You can set multiple styles of the loading effect, including background color, image, and video.

    Note: You need to update the FVS resource to obtain new resources.

    Function Description

    Template Loading

    The template loading effect applies to the whole template, which allows you to set the background color, loading effect, and loading time.

    The following table describes these settings.

    Settings
    Description

    Background Color

    You can customize the loading page background color and set the opacity.

    By default, the color is white, and the opacity is 0 (transparent).

    Loading Effect

    It is deselected by default. After you select Enable Template Loading Effect, you can set the image/video loading effect.

    1. Image

    You can select Resource Center, Custom Upload, and Online Image to set the loading effect.

    After you select the image, you can set the image hue, opacity, etc..

    iconNote:
    The image does not support filling methods. It adapts to the window and is displayed in the center position according to default rules.

    2. Video

    You can select Resource Center, Custom Upload, and Online Video to set the loading effect.

    After you select the video, you can set the filling method and initial volume. However, after you set the volume, the video is played in mute mode by default. You need to enable the sound manually.

    iconNote:
    For details about format requirements for images, see FVS Picture Component.

    Loading Time

    After selecting Enable Template Loading Effect, you can set the loading effect display time (Auto/Custom).

    1. Auto

    It depends on the actual page loading time. When the page loading is finished, the loading effect disappears.

    2. Custom

    If the custom time is longer than the actual page loading time:

    After the page loading is finished, hover your cursor over the page, a close button is displayed, and you can click to exit the loading effect. Besides, you can press the Esc key to exit the loading effect.

    If the custom time is shorter than the actual page loading time:

    The loading effect will be played in a loop until the loading ends, which depends on the actual loading time.

    Component Loading

    The component loading effect supports differentiating loading effects set by 2D and 3D components.

    For details, see the following table.

    Component Type
    Loading Effect

    2D component

    Currently, the 2D component only supports the table component.

    Enable Component Loading Effect is selected by default. You can use 4 spin effects (that is, 4 spin icons).

    You can set the hue, opacity, etc..

    By default, the loading effect will be displayed if the loading time exceeds 3 seconds.

    3D component

    The 3D component includes 3D city scenes, custom 3D scenes, Unity components, and scene maps.

    Enable Component Loading Effect is selected by default. You can select Simple Loading or Animation Loading.

    Simple Loading: The setting content is consistent with that of the 2D component. By default, the loading effect will be displayed if the loading time exceeds 3 seconds.

    Animation Loading: It supports the display of progress bar animation, which is the actual loading progress. The loading effect appears when the loading starts.

    iconNote:
    The above table describes the loading effect that appears when the loading time exceeds 3 seconds by default. You can modify the default time by modifying the db.script file.


    For example, you can modify the time to 1 second, the operation steps are shown as follows:

    1. Go to the db.script file in the path %FR_HOME%\webroot\WEB-INF\embed\finedb.

    2. Press the Ctrl+F keys to search FINE_CONF_ENTITY, and add the statement: INSERT INTO FINE_CONF_ENTITY VALUES('FVSConfig.widgetLoadingDelayTime','1000').

    3. Save the file and restart the project.

    Example

    Creating a Template

    You can download the sample template: FVS 3D City Component Example.fvs.

    1. Choose File > New FineVis Visualization Dashboard in the upper left corner of the designer.

    2. Click My Resource, click Drag or click to open the local template and save it to My Resource to upload the sample template, and click Create to create a template.

    Setting the Loading Effect

    1. Click Template > FVS Template Setting to go to the setting page. Select Loading Effect.

    2. Set the template loading effect:

    Set the background color to be consistent with that of the page (#000000FF).

    Select Enable Template Loading Effect, choose Image > Resource Center, search the loading animation, select jiazaidonghua2, and click Finish.

    3. Set the component loading effect:

    For the 2D component, keep the default settings. For the 3D component, select Animation Loading. Finally, click OK to save the settings and close the settings box.

    Effect Display

    Save the template and click Preview. The following figure shows the preview effect.

    iconNote:
    1. The mobile terminal also supports the loading effect. However, the 3D city in this exapmle is unsupported in the mobile terminal.
    2. The white screen may still appear when you click Preview in the designer to redirect to the browser, which is time-consuming.

    Attachment List


    Theme: FineVis Data Visualization
    • Helpful
    • Not helpful
    • Only read

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

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

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy