All Products
Search
Document Center

DataV:Widget canvas operations

Last Updated:Apr 08, 2025

This topic describes how to operate widgets in the canvas editor. It covers basic features such as dragging, scaling, rotating, and shortcut keys, along with advanced features such as batch configuration and carousel containers, to help you work with widgets more efficiently in dashboards.

Prerequisites

You have created a dashboard. You can create a dashboard from a template, or create a dashboard from a blank canvas.

Access the canvas editor

  1. Access the DataV console.

  2. On the Workspace page, in the Dashboard section, hover over the target dashboard and click Edit to access the canvas editor page of the dashboard.

    On this page, you can perform basic operations, batch configuration, group operations, create carousel containers, and other operations as needed.

Basic features

Operation

Description

Drag

Select one or more widgets from the Widget Library on the left, and hold the left mouse button to drag them.

  • Select a single widget: Click a widget to select it.

  • Select multiple widgets: Hold the Ctrl key (or Cmd key on Mac) and click multiple widgets to select them. Click the corresponding key again to deselect the current widget.

    Note

    You can also use the same method to select one or more widgets in the Layers list on the left.

Scale

After selecting one or more widgets, move the mouse to the edge of the bounding box. When the scaling icon appears, hold the left mouse button and drag.

Rotate

Select one or more widgets, and move the mouse to the white dot near the top edge of the widget. When the rotation icon appears, hold the left mouse button to rotate the widget.

Widget Lock

For more information, see Layer management.

Widget Layer Position Movement

Right-click a widget in the dashboard canvas or layer panel. In the pop-up menu, perform operations such as Bring To Front, Send To Back, Bring Forward, or Send Backward.

Generate Iterator

For more information, see Layer management.

Enter Blueprint Editor

Enter the blueprint editor and directly locate the current widget node to implement complex interaction effects through low-code editing.

Widget Hide

For more information, see Layer management.

Widget Rename

For more information, see Layer management.

Copy ID

Copy the current widget ID value, which can be used for quick search in the canvas editor and blueprint editor.

Widget Copy

For more information, see Layer management.

Widget Delete

For more information, see Layer management.

Widget Favorite

For more information, see Layer management.

Thumbnail

DataV provides a thumbnail feature in the lower-left corner of the canvas. You can use this feature to adjust the layout of widgets on the canvas.

  • Drag the Scale below the thumbnail, or click + or - to adjust the size ratio of the canvas.

  • When widgets exceed the canvas size, you can drag the highlighted blue border of the thumbnail to locate the position of the widgets.image

  • Click the image icon in the lower-left corner of the canvas to turn the thumbnail on or off.

Shortcut Keys

Canvas shortcut keys

  • Select: Mouse click

  • Multiple selection: ctrl/cmd+mouse click

  • Operation menu: Right-click

  • Global search: ctrl/cmd+f

Batch configuration

Operation

Description

Batch Configuration

After selecting multiple widgets, you can make the following batch configurations in the right panel.

1

  • Number 1: Displayed when any widget is selected.

    • Alignment: Set the alignment method for multiple widgets, including but not limited to left align, center align, right align, top align, horizontal align, and bottom align.

    • Distribution: Set the distribution method for multiple widgets, including horizontal distribution and vertical distribution.

    • Object Position: Set the position of the top-left vertex of multiple widgets relative to the canvas.

    • Object Size: Set the width and height values for multiple widgets.

  • Number 2: Displayed when all selected widgets support quick configuration.

    • Chart Color: Set the chart color for multiple widgets.

    • Chart Text: Set the font, font weight, font size, and color of chart text for multiple widgets.

    • Chart Complexity: Set the chart information type for multiple widgets, including simple, general, and detailed.

  • Number 3: This is the Unified Style, which appears only when all selected widgets are of the same type and have the same major version number. For example, if two widgets are both interval bar charts and both are version 5.x, batch settings can be applied.imageimage

Group operations

Operation

Description

Group Operations

  • Group/ungroup: For more information, see Layer management.

  • Search Configuration: Click the Style icon image in the upper right corner of the panel to enter the name of the configuration item you wish to locate in the search field. The system supports fuzzy matching. For more information, see Search configuration item.

  • Size: indicates the size of a widget, including its pixel width and height. You can click the Proportional resizing icon to proportionally adjust the width and height of a widget. After you click this icon again, you can adjust the width and height as needed.

  • Position: the position of a widget, which is indicated by pixel X and Y coordinates. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.

  • Rotation Angle: the angle of a rotation that uses the center point of a widget as the rotation point. The unit is degrees (°). You can use one of the following methods to control the rotation angle of a widget:

    • Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.

    • Drag the black dot in the Rotation control icon icon.

    • Click the Horizontal flip icon to horizontally flip a widget.

    • Click the Vertical flip icon to vertically flip a widget.

  • Opacity: the opacity of a widget. Valid values: 0 and 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.

  • Background: Set the background color and background image of the container after grouping widgets. For more information, see Color picker description.

  • 3D Transformation: Click the image.png icon to enable the 3D transformation feature for the group.

    • Perspective: Set the perspective in chart perspective photography. Set different perspective parameters by configuring the position of the vanishing point.

    • Child Layer Transformation Configuration: Includes two configuration modes: batch configuration and individual configuration. You can set the rotation, scaling, and translation parameters of the chart in either mode.

Note

If you need the carousel feature, click Use Carousel Container. For specific operations, see Carousel container.

Carousel container

A carousel container can gather multiple widgets in a fixed area and dynamically switch between them through various animation effects such as sliding and flipping. If your screen space is limited but you need to display a large amount of data or information, you can use a carousel container.1D1861C9-CD15-4A45-98D7-01DBEB261FE8

Create a carousel container

Access the canvas editor, select all widgets that need to be included in the carousel, right-click any widget, and select Use Carousel Container to create a carousel container. After creation, all widgets in the carousel container will be displayed as a whole in the carousel.

Note
  • You can create multiple carousel containers in a dashboard, but each widget can only be added to one carousel container.

  • If you no longer need to use the carousel container, you can right-click the carousel container and select Remove Carousel Container. After removal, the widgets in the carousel container will return to their independent state.

Configure a carousel container

Click the carousel container to configure its basic style, interaction events, and global variables in the right panel.

  • Style configuration

    In the Style panel, you can configure the animation effect, background color, carousel duration, and other information for the carousel container. The related configuration items are described below.

    Note

    You can also click the image icon to quickly locate the desired configuration item through keyword search, which supports fuzzy match. For more information, see Search for configuration items.

    Configuration item

    Description

    Screenshot

    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

    Carousel style configuration

    Define the animation effect of the carousel:

    • Quick Style: Quickly switch between carousel styles, supporting various styles such as sliding, fade in/out, and flipping.

    • Animation Configuration: Configure the carousel style, the arrangement of widgets in the carousel container (horizontal or vertical), and the carousel duration (in ms).

    image

    Basic Style Configuration

    Define the background, padding and margin, visible count, carousel count, widget spacing, carousel direction, centering effect, and shadow effect of the carousel container. The main descriptions are as follows:

    • Background: Support changing the background color, or uploading a local image as the background.

    • Padding And Margin: Set the distance between the currently displayed widget in the carousel container and the four borders (top, bottom, left, and right).

    • Visible Count: The number of widgets that can be visible at the same time in the carousel container.

      Note

      This only takes effect when the carousel style is configured as Slide or Showcase.

    • Carousel Count: The number of widgets in each carousel.

      Note

      This is typically used when Visible Count is greater than 1, and only takes effect when the carousel style is configured as Slide or Showcase.

    • Spacing: The distance between two widgets in the carousel container.

      Note

      This only takes effect when the carousel style is configured as Slide or Showcase.

    image

    Autoplay And Parallax

    Define the display of autoplay and parallax effects:

    • Delay: Set the interval between two transition animations during autoplay (can be considered as the display duration of a widget), in ms.

    • Pause On Hover: When enabled, autoplay will pause when the mouse hovers over the carousel container.

    • Parallax: Configure the transparency of widgets in the carousel container and the scaling ratio of widgets relative to the carousel container.

    image

    Others

    Click the corresponding button to quickly start, pause, or cancel (remove the carousel container) the carousel container.

    image

  • Advanced configuration

    In the Advanced panel, you can define the interaction and data transfer relationships between the carousel container and other widgets. The related configuration items are described below.

    Configuration item

    Description

    Screenshot

    Interaction Events

    Define interaction configurations with other widgets to achieve widget linkage. Click the image icon to define related interaction events and actions.

    image

    Global Variables

    You can associate global parameters in the carousel container to achieve parameter transfer between widgets for widget interaction.

    Click the image icon to enable the corresponding instruction and associate the required global variables for that instruction. When Carousel To A Page, a temporary variable will be thrown, which by default throws the index field value of the carousel container.