All Products
Search
Document Center

DataV:Digital Ticker Board

Last Updated:Feb 12, 2025

The digital ticker board is widely used to display information such as numbers, counts, or time, and can interact with other widgets to present real-time data changes in visualization applications. This topic outlines the use of the digital ticker board.

Widget overview

Scenarios

The digital ticker board is frequently employed in devices such as clocks, timers, and counters, along with in the financial sector to display amounts, and in businesses to exhibit key metrics. For instance, it can reveal a company's operational metrics to swiftly identify any unusual activity through metric fluctuations.

Effect display

The digital ticker board typically includes a title, prefix/suffix, and ticker content. Below is an example of the digital ticker board displaying the daily sales figures for a specific region.

image

Limits

The ticker content only supports displaying Number types. If your data is not of the Number type, the platform will treat the content as an abnormal character and automatically replace it with specified content. For more information, see Abnormal Character Handling.

Prerequisites

  • A data dashboard is available that supports creation using a template, a blank canvas.

  • Business data is ready for use. For more information, see Data Source.

Add Digital Ticker Board

  1. Log on to the DataV console.

  2. Navigate to Workbench > > All Applications > > Data Dashboard and select the desired dashboard to access the canvas editing page.

  3. From the Widget Library > Information list in the left-side navigation pane, add the Digital Ticker Board widget to the canvas by clicking on it.

You can also use global search to find and add related widgets.

Integrate business data

Once the widget is added, integrate your prepared business data for display. Click the digital ticker board and, on the right-side Data Source tab, select the data for the widget to render. image

  • The data fields accepted by the ticker board are as follows.

    Field

    Description

    name

    (Optional) The title content of the digital ticker board. If not empty, it will overwrite the configuration in the style. If empty, it will use the content in the Style > Basic Style > Title Content configuration item.

    value

    The specific value of the digital ticker board.

    prefix

    (Optional) The prefix content of the digital ticker board. If not empty, it will overwrite the configuration in the style. If empty, it will use the content in the Style > Ticker Board > Prefix Content configuration item.

    suffix

    (Optional) The suffix content of the digital ticker board. If not empty, it will overwrite the configuration in the style. If empty, it will use the content in the Style > Ticker Board > Suffix Content configuration item.

    Here's the data structure and effect display of an example ticker board.

    [
     {
     "name": "This is the title",
     "value": 232425
     }
    ]

    image

  • The key configuration items for the data source are as follows.

    Configuration Item

    Description

    Select Data Source

    Supports integrating various types of data such as CSV files, APIs, and various databases. For more information, see Data Source. You can edit data fields using a visual table or code.

    Configure Filter (Optional)

    Used to customize filter code to achieve data structure transformation, filtering, display, and simple calculations. For more information, see Manage Data Filters.

    Configure Data Mapping

    Used to map fields from the selected data source to the corresponding fields of the widget to achieve real-time data matching. Click the image icon to configure field styles.

    View Response Results

    Used to display the data integrated into the widget in real-time. When the widget data source changes, the latest data will be displayed here.

    • Click the data response result to view the code of the data fields written.

    • Click to view the example to see the array type and code example received by the data source. You can refer to the example to write related fields.

    Other data request configurations:

    • Disable Loading State: When selected, the loading content during widget initialization will not be displayed when updating or previewing the data dashboard.

    • Controlled Mode: When selected, the widget will not request data in the initialization state. At this time, data requests can only be initiated through the blueprint editor or global variable events.

    • Automatic Update Request: When selected, the platform will dynamically poll and update data according to the polling time you set. If not selected, you need to manually refresh the page or trigger a request to update data through the blueprint editor and global variable events.

Configure Digital Ticker Board

Style Configuration

The digital ticker board's style can be adjusted through basic and full configuration options, which are switchable at the top of the style tab. Basic configuration covers color and text settings, while full configuration includes a wider range of options. This topic demonstrates using the full configuration to detail related settings.

Note
  • Use the image icon for quick access to configuration items via keyword search, which supports fuzzy match. For more information, see Search Configuration Items.

  • Title, prefix, and suffix content can be sourced from the data source, with platform configurations taking precedence. If the data source lacks related content, the style settings will be applied.

The configuration items are detailed below.

Configuration Item

Description

Illustration

Global Configuration

Defines the position distribution, transparency, and interaction penetration of the widget in the data dashboard.

  • Opacity: The smaller the value, the more transparent the widget. The value range is within 0~1.

  • Interaction Penetration: When enabled, the mouse can penetrate this widget to avoid the widget blocking the interaction between the mouse and the underlying widget when there are many widgets on the dashboard.

image

Basic Style Configuration

Defines the size, color, shadow effect, relative position, and spacing of the title text and ticker board, along with the font size automatic rotation effect of the ticker board. It also supports customizing the display content when the widget is initialized or when abnormal characters appear.

  • Font Size Automatic Rotation: When enabled, manually set ticker board width, height, spacing, etc., will not take effect. The platform will recalculate and adapt the ticker board's width, height, spacing, etc., based on the font size of the ticker board you configured.

  • Initialization Character: The numerical content displayed by the ticker board when the widget is initialized (that is, the value of Value in the data source).

  • Abnormal Character: When the Value in the widget data source is not of the Number type, the platform will treat the value as an abnormal character. At this time, the numerical content displayed by the ticker board will be replaced with the configuration value of the Abnormal Character parameter.

image

Ticker Board Configuration

Defines the overall layout of the ticker board content (including numbers, prefixes, and suffixes), the style and layout of the numbers, and the font style and shadow effect of the prefixes and suffixes.

The number configuration instructions are as follows:

  • Font: Only supports using fonts installed by the system. For more information about fonts, see Font Library.

  • Layout: You can set the spacing, width, and height of the numbers, along with the width of the separator.

    • When the spacing, height, and width of the numbers are 0, it means system automatic rotation.

    • When Fixed Width Separator is enabled, a specific width separator will be used by default to separate the data, making the boundaries of the data area clearer and the display effect clearer.

  • Background: The value and separator of the ticker board can have background and border styles set, and support uploading local images as the background.

    Note

    When the color of the numbers is set to gradient, the background of the numbers will be invalid.

  • Digits: You can set how many digits the ticker board displays (including decimal places). The platform will automatically add separators and decimal points based on your configuration.

    • When the digits are 0, it means system automatic rotation.

    • When rounding is enabled, the value will be directly rounded to an integer for display. When disabled, the original value will be displayed.

    Note

    If the configured digits are less than the actual data length, the excess part at the head will be omitted. Conversely, 0 will be added to the head of the value.

  • Separator: Supports setting thousands separator and decimal separator.

    Note

    The separator can be at most one character long. If it exceeds one character, the first character will be taken, and numbers cannot be used as separators.

image

Interaction Configuration

Sets the animation effect of the ticker board (such as animation duration and data jitter correction) and gesture cursor.

  • Data Jitter Correction: When enabled, it protects the ticker board data from falling, meaning it can only show an increase. When disabled, the ticker board data will show both rise and fall.

  • Gesture Cursor: When enabled, the mouse will display as a gesture cursor when hovering over the ticker board widget during dashboard preview.

image

Advanced Configuration

This defines the interactions and data flow between the ticker board and other widgets. The configuration items are detailed below.

Configuration Item

Description

Illustration

Interaction Occurrence

Defines the interaction behavior with other widgets to achieve widget filter interaction. For example, the ticker board can integrate sales data tables of multiple stores in the current area. When the store sales data changes, the ticker board will display the daily total sales amount of the current area in real-time.

Click the image icon to define related interaction occurrences and interaction actions.

image

Associate Global Variable

Global parameters can be associated in the widget to achieve parameter transmission between widgets and widget interaction. Click the image icon to enable the corresponding instruction and associate the required global variable for the instruction.

Blueprint Interaction

Use the blueprint editor to visually define widget interactions and behavior logic.

Procedure

  1. On the canvas editing page, click the image icon in the top menu bar's left side to access the blueprint editor.

  2. Hover over the digital ticker board widget in the layer node list and click the image to add it to the main canvas.

  3. Configure the blueprint interaction effects for related widgets as needed.

    Here's an example. image

Configuration Item Introduction

The interaction occurrences and actions are detailed below.

Category

Child Category

Description

Occurrence

When Data Is Updated

This occurrence is triggered when the widget data is updated.

When Request Status Changes

This occurrence is triggered when the request status changes. Status values include Loading, Success, and Error.

When Current Value Changes

This occurrence is triggered when the current value changes, and the corresponding data item is also thrown. The data example is as follows.

{
  "value": "23"
}

When Ticker Board Is Clicked

This occurrence is triggered when the ticker board is clicked, and the corresponding data item is also thrown. The data example is as follows.

{
  "value": "23"
}

Occurrence

Import Data

After the data is processed according to the widget rendering format, it is imported into the widget and redrawn. There is no need to request server data again. The data example is as follows.

[
  {
    "name": "Third Quarter Turnover",
    "value": 283699,
    "prefix": "¥",
    "suffix": "Yuan"
  }
]

Request Data

Re-request server data. The data thrown by the input data processing node or layer node will be used as a parameter. For example, if the API data source configured by the digital ticker board is https://api.test, and the data passed to the Request Data action is { id: '1'}, the final request interface will be https://api.test?id=1.

Reset Current Value

Set the current number to zero without parameters.

Shift

Move the widget to a specified position. The data example is as follows.

    {
      // Movement method. Absolute positioning: to, relative positioning: by. Default value: to.
        "positionType": "to",
      // Specified position. x-coordinate, y-coordinate.
      "attr": {
        "x": 0,
        "y": 0
      },
      // Animation method.
      "animation": {
        "enable": false,
        // Animation delay.
        "animationDuration": 1000,
        // Animation curve. Optional values are: linear|easeInOutQuad|easeInOutExpo.
        "animationEasing": "linear"
      }
    }

Switch Visibility

Switch the widget to show or hide. The data example is as follows.

{
  "animationType": "fade",
  "animationDuration": 1000,
  "animationEasing": "linear"
}
  • animationType: Animation method. It can be configured as appear (appear/disappear), fade (fade in/fade out), slideToUp (fly in/fly out). If not configured, it means no animation.

  • animationDuration: Animation delay, default is 1000ms.

  • animationEasing: Animation curve. It can be configured as linear (uniform speed), easeInOutQuad (smooth), easeInOutExpo (slow-fast-slow).

Show

Hide

Update Widget Configuration

Dynamically update the style configuration of the widget.

  1. First, in the Style panel of the widget, click Copy Configuration To Clipboard to obtain the configuration data of the widget.

  2. As needed, change the field values of the corresponding style in the data processing node on the blueprint editor configuration page.

Demo

For a demonstration of the digital ticker board in action, see Implement Dynamic Data Summation.