Image Carousel

  • Last update:March 10, 2025
  • Overview

    Version

    Report Server Version
    Plugin VersionFunctional Change

    11.0

    1.0.0

    /

    11.0

    3.0.1

    Added the functions for you to preview images in full screen/zoom in images, view prompt content, and be redirected to web links.

    Application Scenario

    You want to dynamically display enterprise cultures/products/services in company's official website, and latest products/promotions on e-commerce platforms by images, and hope to be redirected to web links by clicking images, as shown in the following figure.

    图片轮播 图0.gif

    Function Description

    FanRuan provides the Image Carousel plugin mainly to display images dynamically.

    • Horizontal and vertical carousel is supported.

    • You can be redirected to web links by clicking images.

    • Autoplay with a custom duration and interval is supported.

    • This plugin is not supported in IE browsers. You are advised to use Google or Firefox browsers.

    • This plugin is not supported on mobile terminals.

    Plugin Introduction

    Plugin Installation

    You can obtain the plugin at https://community.finereport.com/plugin/?id=135.

    For details about how to install the plugin in the designer, see Designer Plugin Management.

    For details about how to install the plugin on the server, see Server Plugin Management.

    Function Entry

    1. General Report

    Select and resize a cell, click the Insert Chart icon on the upper toolbar, and click Image Carousel, as shown in the following figure.

    图片轮播 图1.png

    2. FVS Visualization Dashboard

    Add a table component in FVS. Edit the table, select the Insert Chart icon on the upper toolbar, and select Image Carousel in the chart type window, as shown in the following figure.

    iconNote:
    FVS only allows you to insert Image Carousel in Table components but does not allow you to use Image Carousel directly in Chart components.

    图片轮播 图2.png

    3. FRM Dashboard

    On the upper chart toolbar in an FRM dashboard, select the Image Carousel Chart icon to add the chart, as shown in the following figure.

    iconNote:
    The FRM dashboard allows you to use Image Carousel in a report/chart block.

    图片轮播 图3.png

    Attribute Setting

    Choose Cell Element > Setting on the right, as shown in the following figure.

    图片轮播 图4.png

    The following table describes details.

    Setting
    Description

    Basic

    Image Layout

    Image display layout, which includes the following types:

    • Layout 1: The entire object (namely the content for replacement) will completely fill the element's content box. If the aspect ratio of the object does not match that of the content box, the object will be stretched to fit the content box.

    • Layout 2: The entire object (namely the content for replacement) will be scaled to maintain its aspect ratio while filling the element's content box. If the aspect ratio of the object does not  match that of the content box, the object will be framed in black.

    • Layout 3: The entire object (namely the content for replacement) will maintain its aspect ratio while filling the element's content box. If the aspect ratio of the object does not match that of the content box, the object will be cropped to fit the content box.

    Animation Type

    Image carousel direction, which can be set to:

    • Slide

    • Scroll

    Show Control Button

    Whether to show the control button. If the checkbox is selected, the button for manual carousel control is displayed.

    Link Opening Event

    Carousel image click event for redirecting you to a web link, which can be set to:

    • No Click Event

    • Click Event

    • Double-Click Event

    • Right-Click Event

    If you select No Click Event, you will not be redirected to any link when clicking an image.

    Link Opening Method

    Method for redirecting you to a web link when you click a carousel image, which can be set to:

    • Open in New Window

    • Open in Current Window

    Autoplay

    Whether to enable automatic image carousel. If you select Autoplay, images are automatically played in the carousel way.

    You can customize Animation Duration(ms) and Animation Interval(ms).

    Image File

    Image file to be added.

    Configuration Method:

    (1) Add/Modify

    Enter the image file address, web link, and prompt content.

    Click Add to add the corresponding information to the following list.

    Select a row in the following list and click Modify to modify the content.

    (2) Remove/Move Up/Move Down

    Select a row in the following list and click Remove/Move Up/Move Down to delete or resort the content.

    Configuration Requirement:

    (1) Image File:

    This parameter specifies the image source displayed during preview. You can enter a disk file and an absolute path.

    • Disk File: Images in /webroot/WEB-INF/resources of the project and subfolders of the resources folder can be read. Just enter the relative path of the image file in resources.

    • Absolute Path: You can enter the accessible image URL and click Test URL to ensure that the URL is accessible.

    (2) Web Link

    This parameter specifies the web link to which you are redirected after you click an image. If this optional parameter is left empty, you will not be redirected.

    (3) Prompt Content

    This parameter specifies the prompt content displayed when you hover your cursor over an image. If this optional parameter is left empty, no prompt content is displayed.

    图片轮播 图5.png

    Dataset

    Dataset from which image configuration is obtained.

    The path rule and configuration description are all consisitent with those under Image File > Edit.

    Image Zoom During Preview

    In the Pagination Preview mode, you can preview an image in full screen or zoom in/out an image.

    (1) When you hover your cursor over a carousel image, a full-screen icon  will appear in the upper right corner of the image. You can click the icon to preview the image in full screen.

    (2) On the full-screen image preview page, you can drag the image or scroll your mouse wheel to zoom in/on the image.

    (3) You can click the exit icon  in the upper right corner of the full-screen image preview page to exit the image preview.

    Example

    Image Resource Preparation

    You can download and decompress Carousel Image Sample.zip to obtain sample images.

    Place sample images into /webroot/WEB-INF/resources of the project, as shown in the following figure.

    图片轮播 图6.png

    New Chart

    1. Create a general report.

    2. Resize the cell as required and select the cell.

    2. Click the Insert Chart icon on the upper toolbar, and select Image Carousel.

    图片轮播 图7.png

    Chart Attribute Setting

    1. Select the cell where the chart is located and click Cell Element.

    2. Click Setting.

    • Basic: Select Show Control Button and retain the default settings of other attributes.

    • Autoplay: Select Autoplay and retain the default settings of other attributes.

    • Image File: Click Edit, select the sample images respectively in Disk File, and add the corresponding web links and prompt contents, as shown in the following figure.

    图片轮播 图8.png

    Effect Display

    Save the template and click Pagination Preview. The effect is the same as that shown in section "Application Scenario."

    iconNote:
    The effect cannot be previewed on mobile terminals.

    Template Download

    You can download the template Image Carousel.cpt.

    Attachment List


    Theme: Chart
    • Helpful
    • Not helpful
    • Only read

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

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

    不再提示

    9s后關閉

    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