Custom Path

更新时间:
复制 MD 格式

Use the Custom Path widget to show an object's path between two points. This topic describes how to add and configure the Custom Path widget.

Chart style

The Custom Path widget lets you set the style and path of a moving object. This provides a clear visualization of the object's entire movement.

image

Prerequisites

A data dashboard must be created. You can create a dashboard using a template, using a blank canvas, or using AI generation.

Add a custom path component

  1. Access the DataV console.

  2. On the Workbench > All Applications > Data Dashboards page, click the target dashboard to open the canvas editor.

  3. In the navigation pane on the left, add the Custom Path widget to the canvas as shown in the figure.

You can also add the widget by using global search.

Configure a custom path component

Click the Custom Path widget. In the pane on the right, you can configure the basic styles, advanced configurations such as global variables and interaction occurrences, and blueprint interactions.

Style configuration

The configuration items are described below.

Configuration Item

Description

Illustration

Basic configuration

Set the widget's position, transparency, and click-through behavior on the data dashboard.

  • Opacity: The smaller the value, the more transparent the widget. The value ranges from 0 to 1.

  • Click-through: If you enable this option, you can click through the widget. This prevents the widget from blocking mouse interactions with layers underneath, which is useful on a crowded dashboard.

Global configuration

Set the movement path and its style. Styles include solid or dashed lines, line thickness, and color.

Define the path in one of the following ways:

  • File Upload: Upload an SVG file. The file must contain SVG tags that describe a two-dimensional vector graphic. Hover over the image and click Change to upload official design resources or your own local files.

  • String: Enter SVG path data. For example, M433.771416,3.94926004 C347.141186,5.69356279 274.845026,48.3758822 216.882935,131.996218 C158.920845,215.616554 86.6246843,258.267568 -0.00554592745,259.94926.

Note

Scalable Vector Graphics (SVG) is a format used to represent complex curves or paths.

Image configuration

Set the style of the moving object. You can use a circle, a rectangle, or a custom image.

Hover over the image and click Change to upload official design resources or your own local files. You can also set the style of the image or shape, such as its width, height, color, and border thickness.

Note

The style settings vary based on the moving object. Refer to the user interface (UI) for the actual options.

Animation configuration

Set the animation effects for the path. This includes the direction, duration, path range, and speed.

  • Direction: Options include forward, reverse, forward and back, and reverse and back.

  • Path Range: A value from 0 to 100.

    • 0: The object stays at the starting point.

    • 100: The object stays at the end point.

    • 50: The object moves from the start point to the midpoint and then stops. It does not continue to the end point.

  • Speed: Set the speed of the moving object as needed.

Advanced Configuration

The configuration items are described below.

Configuration Item

Description

Diagram

Interaction occurrence

Define interaction behaviors with other widgets to enable filter interactions. For example, you can use this widget to display flight information. When the Custom Path widget starts moving, a List Carousel widget can display the current flight's location.

Click the image icon to define interaction occurrences and actions.

Associate global variables

Associate global parameters with the widget to pass parameters between widgets for interaction. Click the image icon to enable an instruction and associate the required global variables with it.

Blueprint interaction

You can use the Blueprint Editor to define interaction relationships and logic between widgets using visual connections. Follow these steps:

  1. On the canvas editor page, click the image icon on the left of the top menu bar to open the Blueprint Editor.

  2. In the layer node list, hover over the Custom Path widget and click the image icon to add the widget to the main canvas.

  3. Use connections to configure the blueprint interaction effects for the widgets as needed.

    The following figure shows an example.