callout-comparison-pie-chart

更新时间:
复制 MD 格式

Configure a callout comparison pie chart by setting its style, data source, and blueprint interaction options.

Chart style

A callout comparison pie chart is a type of pie chart that supports switching between real values and percentage values, multi-series data configuration, and label, legend, and animation settings. It is suitable for displaying proportional data. image.png

Style Panel image.png

  • Search Configuration: Click the Search configuration items icon imagein the upper-right corner of the Style panel to search for a configuration item by name. Fuzzy match is supported. For more information, see Search configuration items.

    • Size: the width and height of the widget. Unit: pixels.

    • Positioning: the x-axis and y-axis position of the widget. Unit: pixels. X-coordinate is the pixel distance from the upper-left corner of the widget to the left border of the canvas. Y-coordinate is the pixel distance from the upper-left corner of the widget to the top border of the canvas.

    • Rotate: Rotate the widget by a specified number of degrees.

      • Enter a value in the Rotation Angle spin box, or click the plus (+) or minus (-) sign to adjust the value.

      • Click the imageicon to flip the widget style.

      • Click the imageicon to flip the widget style.

    • Opacity: Valid values: 0 to 1. A value of 0 hides the widget, and a value of 1 fully displays it. Default value: 1.

  • Chart name

    • Pie Chart Style

      Decoration Color: the decoration color of the outer circle and the center of the pie chart.

    • Value Label

      Parameter

      Description

      Text

      The font style, weight, size, and color of the numeric label text.

      Real Value

      Turn on the switch to display actual data values. Turn off the switch to display percentage values.

      Number of decimal places

      The number of decimal places for the displayed value. Available only when Real Value is turned off.

    • Category Label: the category label style. Click the 开关图标icon to show or hide the category label.

      Text: the font style, weight, size, and color of the category label text.

    • Legend: the legend style of the chart. Click the 开关图标icon to show or hide the legend.

      Parameter

      Description

      Text

      The font style, size, color, and weight of the legend text. For more information, see color picker instructions.

      Layout

      The layout of the legends.

      • Spacing

        • Left and Right Spacing: The horizontal distance between adjacent legends. This parameter takes effect only when multiple series exist.

        • Distance: the vertical distance between the legend and the widget boundaries.

      • Position: the position of the legend relative to the start coordinates of the widget. You can select Top Left, Top Center, Top Right, Bottom Left, Bottom Center, or Bottom Right.

  • Axis: the radial and angular axes of the pie chart.

    • Radial axis

      Parameter

      Description

      Radius

      The radius of the radial axis, as a proportion of the widget height. Valid values: 0 to 1.

      Grid Line

      The grid line style of the radial axis. Click the 开关图标icon to show or hide the grid line.

      Color: the color of the grid lines.

    • Angle Axis

      Start Angle Offset: the offset of the start angle of the pie chart. Default value: auto.

  • Edition

    data series: Click the imageor imageicon to add or delete a data series. Click the imageor imageicon to reorder data series. Click the imageicon to duplicate a data series with the same configurations.

    Color: the color of the sector in this series.

  • Remarks

    Emotion Animation: the animation style of the pie chart. Click the 开关图标icon to enable or disable the animation.

    Parameter

    Description

    Animation Settings

    • EASING: the easing effect of the animation. Multiple common easing effects are available.

    • Sequential Animation of Each Series: If the switch is turned on, sector animations play sequentially by series. If the switch is turned off, all sector animations play simultaneously.

    • Start at Zero: If you turn on the switch, each sector animates from zero during the initial render. If you turn off the switch, all sectors animate from their starting positions simultaneously during the initial render.

    Admission Animation

    The duration of the initial animation. Unit: ms.

    Update Animation

    • Update Animation Duration: the duration of the animation when the widget data is updated. Unit: ms.

    • Start From Previous Position: If you turn on the switch, the animation starts from the previous position on data update. If you turn off the switch, the animation starts from the initial position on data update.

Data Sources panel image.png

Column

Description

x

The category of each sector.

y

The value of each sector, which determines the percentage of each sector in the entire pie chart.

Configure data items

Description

DataSource

Use the code editor or visual editor to view and edit the data fields of the widget. You can also change the Data Type to configure the data source.

Data Mapping

Map custom fields to widget fields in the Data Mapping module, allowing you to match data without modifying the data source fields. Click the imageicon to configure the field style.

Configure a filter

Turn on Filter, select or create a data filter, and configure a filter script to process data. For more information, see Manage data filters.

Data Response Result

Displays real-time widget data. When the data source changes, the latest data is shown. Click the imageicon to view the current response result, or click the imageicon to refresh the data. You can also click View Example to see a sample response.

Forbid Loading

Select this check box to hide loading content during widget initialization when previewing the dashboard. By default, this option is deselected.

Controlled Mode

Select this check box to prevent the widget from requesting data during initialization. In controlled mode, data is requested only through global variables or methods configured in Blueprint Editor. By default, this option is deselected.

Auto Data Request

Select this check box and set a polling interval to enable automatic data refresh. When cleared, you must manually refresh the page or use Blueprint Editor and global variable events to trigger data updates.

Advanced Panel

This widget does not support interaction events.

Blueprint Interaction

  1. Click the imageicon in the upper-left corner to go to the Blueprint page.

  2. On the Layer Nodes tab, add the widget to the main canvas.

  3. View blueprint configuration parameters. image.png

    • Event

      Event

      Description

      When the callout comparison pie chart interface request is completed

      Triggered after a data interface request is completed and the response is processed by a filter. The processed JSON data is returned. For data examples, see the Data Response Result section on the Data Source tab in the right-side configuration panel.

    • Action

      Action

      Description

      Import Labels to Compare Pie Chart

      Redraws the widget with pre-processed data without requesting server data again. For data examples, see the Data Response Result section on the Data Source tab in the right-side configuration panel.

      Request labeling comparison pie chart interface

      Requests server data again, using data from an upstream data processing node or layer node as the parameter. For example, if the API data source is set to https://api.test and the data passed to the Request Labeling Comparison Pie Chart API is set to { id: '1'}, the final request interface is https://api.test?id=1.

      Clear components

      Clears the widget. No parameters are required.

      Move

      Moves the widget to a specified location. See the following data example.

          {
            // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. 
              "positionType": "to",
            // The location, which is indicated by the x and y coordinates. 
            "attr": {
              "x": 0,
              "y": 0
            },
            // The animation type. 
            "animation": {
              "enable": false,
              // The animation delay. Unit: milliseconds. 
              "animationDuration": 1000,
              // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }

      Switch Display /Display

      Toggles whether the widget is displayed or hidden. No parameters are required.

      Display

      Displays the widget. See the following data example.

      {
        "animationType": "",// The animation method. Valid value: fade. If you do not set this parameter, no animation is available. 
        "animationDuration": 1000,// The animation delay. Unit: ms. 
        "animationEasing": ""// animation curve
      }

      Hide

      Hides the widget. See the following data example.

      {
        "animationType": "",// The animation method. Valid value: fade. If you do not set this parameter, no animation is available. 
        "animationDuration": 1000,// The animation delay. Unit: ms. 
        "animationEasing": ""// animation curve
      }

      Update component configurations

      Dynamically updates widget style configurations. In the Style panel, click Copy Configuration to Clipboard to obtain the widget configuration data, then modify the style field in the data processing node of Blueprint Editor.