Display query results on a bubble chart

更新时间:
复制 MD 格式

This topic describes the chart style and configuration panel of a bubble chart in a mobile widget.

Chart style

A bubble chart is a type of scatter chart in the mobile widget. Compared with a scatter chart, a bubble chart uses bubbles to display data. You can customize the size of bubbles to visually and vividly display the differences between discrete data at multiple time points. image

Configuration Panel image

  • Search Configuration: Click Search Configuration in the upper-right corner of the Configuration panel. In the Search Configuration panel, enter the name of the configuration items that you want to search for to quickly locate the configuration items. Fuzzy match is supported. For more information, see Search for asset configurations.

  • Chart name

    • Custom Margins: the distance between the bubble chart area and the upper, lower, left, and right borders of the widget. The default unit is px. You can click the 眼睛图标icon to specify the custom margins.

    • Bubble Size: the minimum and maximum radius of the bubble. Default value: px.

      Note

      Set the bubble size and use it to map the r field in the data, that is, the smallest r value will be drawn as the bubble with the smallest radius, the largest r value will be drawn as the bubble with the largest radius, and the rest of the data will be proportionally distributed.

    • Stroke: the color and width of the bubble.

    • Legend: the legend style of the bubble chart. You can click the 眼睛图标icon to display the legend.

      Parameter

      Description

      Click to filter

      If you turn on the switch, when the widget is configured with multiple series data, use a mobile device in the preview or publish state of the widget, and click a legend of a series in the widget to switch the current series to the selected or unselected state, thus filtering and displaying data of different series in the visualization application. If you turn off the switch, data of different series cannot be filtered and displayed, and legend data of all series is displayed at the same time.

      No Color Selected

      The legend color of each series when it is not selected.

      Layout

      The layout style of the legend. You can adjust the position and alignment of the legend layout.

      Marker shape

      The shape of the legend. Valid values: Round and Square.

      Text

      The text style of the legend.

      • Font Size: the size of the legend text.

      • Text Width: the weight of the legend text.

      • Color: the color of the legend text.

      • Alignment: the alignment of the legend text. Valid values: Center, Left, and Right.

  • Axis: You can select x-axis or y-axis.

    • X Axis

      • Show: If you turn on the switch, the x-axis style in the widget is visible. If you turn off the switch, the x-axis style in the widget is invisible.

      • Type: the type of the x-axis label data. Valid values: Number, Category, and Time.

        Note

        If the data format and specified data types are not consistent, the widget is displayed abnormally.

        Parameter

        Description

        Numerical Type

        Supports numeric data such as integers and floating-point numbers.

        Category Type

        Data of category types such as character and string is supported.

        Time Type

        The data of the time type needs to be configured data format.

      • Number of Scales: the number of scales on the x-axis of the widget.

      • Scale Optimization: If you turn on the switch, the scale on the x-axis of the widget is automatically optimized. If you turn off the switch, you need to customize the maximum and minimum values of the scale on the x-axis of the widget. This parameter is displayed only when you set the X-Axis Type parameter to Numerical.

      • Leave White: the ratio of white space between the two sides of the x-axis. Valid values: 0 to 1.

      • Axis Label: the style of the x-axis label of the bubble chart. You can click the 眼睛图标icon to display or hide the x-axis label.

        Parameter

        Description

        Display Format

        The display format of the x-axis label content. If the x-axis type is numeric, you can select Original, 11 (integer), 11.1 (floating point), or 11.11 (floating point). If the x-axis type is time, you can select different time display styles. This parameter is displayed only when you set the X-Axis Type parameter to Numerical or Time.

        Label Offset

        The up-down displacement distance of the x-axis labels. Unit: px.

        Text

        The font size, text weight, color, and alignment style of the x-axis label text.

      • Grid: the style of the x-axis gridlines. You can click the 眼睛图标icon to display or hide the x-axis gridlines.

        Parameter

        Description

        Color

        The color of the x-axis grid lines.

        Width

        The width value of the x-axis grid lines.

        Linetype

        The shape of the x-axis grid line. Valid values: Solid, Dashed, and Dotted.

      • Axis: the style of the x-axis. You can click the 眼睛图标icon to display the x-axis.

        Parameter

        Description

        Color

        The color of the x axis.

        Width

        The width value of the x-axis.

        Linetype

        The shape of the x-axis line. Valid values: Solid, Dashed, and Dotted.

      • Tick mark: the style of the tick mark on the x-axis. You can click the 眼睛图标icon to show or hide the tick mark on the x-axis.

        Parameter

        Description

        Color

        The color of the x-axis tick marks.

        Linetype

        The shape of the scale line on the x-axis. You can select solid lines, dashed lines, or dotted lines.

        Width

        The width value of the x-axis tick mark.

        Length

        The length value of the x-axis tick mark.

    • Y-axis

      • Display: If you turn on the switch, the y-axis style in the widget is visible. If you turn off the switch, the y-axis style in the widget is invisible.

      • Type: the type of the y-axis tag. Valid values: Number, Category, and Time.

        Note

        If the data format and setting formats are not uniform, the widget will be displayed abnormally.

        Parameter

        Description

        Numerical Type

        Supports numeric data such as integers and floating-point numbers.

        Category Type

        Data of category types such as character and string is supported.

        Time Type

        The data of the time type needs to be configured data format.

      • Number of ticks: the number of ticks on the y-axis of the widget.

      • Scale Optimization: If you turn on the switch, the scale in the y-axis of the widget is automatically optimized. If you turn off the switch, you need to customize the maximum and minimum values of the scale in the y-axis of the widget.

      • Custom: Specify the maximum and minimum values.

      • Leave White: the ratio of white space between the two ends of the y-axis. Valid values: 0 to 1.

      • Axis Label: the style of the y-axis label of the bubble chart. You can click the 眼睛图标icon to display or hide the y-axis label.

        Parameter

        Description

        Display Format

        The display format of the y-axis label value. Valid values: Original, 11 (integer), 11.1 (floating-point number), and 11.11 (floating-point number).

        Label Offset

        The up-down displacement distance of the y-axis label. Unit: px.

        Text

        The font size, text weight, color, and alignment style of the y-axis label text.

      • Grid: the style of the grid lines in the y-axis. You can click the 眼睛图标icon to display or hide the grid lines in the y-axis.

        Parameter

        Description

        Color

        The color of the y-axis grid lines.

        Width

        The width value of the y-axis gridlines.

        Linetype

        The shape of the line in the y-axis grid. You can select Solid, Dashed, or Dotted.

      • Axis: the style of the y-axis. You can click the 眼睛图标icon to display or hide the y-axis.

        Parameter

        Description

        Color

        The color of the y-axis.

        Width

        The width value of the y-axis.

        Linetype

        The shape of the line along the y-axis. You can select solid, dashed, or dotted.

      • Tick Mark: the style of the tick mark in the y-axis. You can click the 眼睛图标icon to display the tick mark.

        Parameter

        Description

        Color

        The color of the tick marks on the y-axis.

        Linetype

        The shape of the scale line on the y-axis. You can select solid lines, dashed lines, or dotted lines.

        Width

        The width value of the y-axis tick mark.

        Length

        The length value of the y-axis tick mark.

  • Edition

    data series: Click the 加号图标or 垃圾桶图标icon on the right to add or delete a data series. Click the 横向排列图标or 竖向排列图标icon on the right to configure the arrangement style of multiple data series. Click the 复制图标icon to copy the selected data series configuration and add a data series with the same configuration.

    Point Style: the style of the bubble point.

    Parameter

    Description

    Color

    The color of the bubble point.

    Shape

    The shape of the bubble. You can select solid circle or square.

  • Remarks

    • Easing Animation: the animation effect style of the chart. You can click the 眼睛图标icon to enable or disable the animation effect.

      Parameter

      Description

      Easing Effect

      The easing effect of animation. The system provides a variety of common easing effects for you to choose from.

      Admission Animation

      The duration of the first animation rendered by the component. Unit: ms.

      Update Animation

      The duration of the animation when the component data is updated. Unit: ms.

    • dialog box: the style of the dialog box that appears when you move the pointer over or click a polyline dot in a bubble chart on the preview or publish page. You can click 眼睛图标the icon to turn the dialog box effect on or off.

      Parameter

      Description

      Series Name

      dialog box the font size and name color of the displayed series names.

      Value

      dialog box the font size and color of the displayed values.

      Gridlines

      You can click 眼睛图标the icon to turn on or off the dialog box guide line effect.

      • Width: dialog box a value for the width of the guide line.

      • Line Type: dialog box the line shape of the auxiliary line, which can be solid, dotted, or dotted.

      • Color: dialog box the color of the auxiliary line.

      Background Box

      The background box style of the dialog box.

      • Fillet: the fillet size of the dialog box background frame. Unit: pixels. When the value is 0, there is no rounded corner, and the background box is square. The larger the setting value, the larger the radian value of the rounded corner.

      • Color: The background color of the dialog box.

Data dashboard

image

Column

Description

x

The x-axis data of each bubble in the bubble chart. The field type and format must be consistent with the label data type and format on the x-axis in the configuration items.

y

The y-axis data of each bubble in the bubble chart. The field type and format must be consistent with the type and format of the label data on the y-axis in the configuration items.

r

The mapping value of the radius of each bubble in the bubble chart. The actual radius value is proportional to the value of the bubble size configuration items in the configuration panel.

s

Optional. The series values of the bubble chart.

Parameter

Description

Controlled Mode

If you turn on the switch, data is not requested when a widget is initialized. Data requests are triggered only based on callback IDs or the method configured in Blueprint Editor. If you turn off the switch, data requests are automatically triggered. By default, the switch is turned off.

Auto Data Request

After you select the Auto Data Request check box, you can enable dynamic polling, and manually specify the polling interval. If you clear the check box, the data is not automatically updated. You must manually refresh the page or use the Blueprint Editor and callback ID events to trigger a request to update the data.

Data source

Click Configure Data Source. In the Configure Data Source panel, modify the data source type and query code, preview the response of the data source, and view the response results. For more information, see Configure a component data source.

Data Filter

If you select the Data Filter check box, you can convert the data structure, filter data, and perform simple calculations. Click Add Filter. In the Set Data Source panel, configure a data filter script. For more information, see Use a data filter.

Data Response Result

The response to a data request. If the data source changes, you can click the 刷新图标 icon on the right to view the response results in real time.

Interactive Panel image

Select the Enable check box to enable interactions between widgets. When you click a dot in the bubble chart, a data request is triggered, a callback value is thrown, and data of different dots is dynamically loaded. By default, the x value in the data is returned. For more information, see Component interaction configuration.

Blueprint Interaction

  1. In the canvas editor, right-click a widget in the layer pane and select Export to Blueprint Editor.

  2. Click the 蓝图图标 icon in the upper-left corner of the page.

  3. In Blueprint Editor, click the Bubble Chart widget in the Added Nodes pane. You can view the parameters of the Bubble Chart widget on the canvas, as shown in the following figure. 气泡图蓝图参数

    • Event

      Event

      Description

      When the bubble chart interface description request is completed

      The event is triggered with the processed JSON data after a data interface request is responded and processed by a filter. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.

      When a bubble chart interface description request fails

      When a data interface request fails (the request failure may be: network problems or interface errors, etc.), the event is returned and thrown after being processed by the filter, and the processed JSON format data is also thrown. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.

      When a data item is clicked

      The event that is raised when a dot in a bubble chart is clicked, and the data item corresponding to the dot is also raised.

    • Action

      Action

      Description

      API description of a request bubble chart

      This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, if the API data source is https://api.test and the data passed to the Request Bubble Chart API Description action is { id: '1'}, the final request interface is https://api.test?id=1.

      Import bubble chart interface description

      After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.