polar-area-chart

Chart style

A polar area chart chart is a type of pie chart in the mobile widget. It supports the label display outside the chart, the display by type, and the multi-series data configuration. It can clearly and intelligently display the proportion of each type.

Configuration Panel

• 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 margin: the distance between the polar area 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 margin.

  • Legend: the legend style of the polar area chart. You can click the icon to display or hide 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: Circle and Square.
    Text	The text style of the legend. Font Size: the size of the legend text. Text Size: 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: polar area chart angle axis and radial axis styles.

  • Radial axis

    • Radius

      Parameter	Description
      Outer radius	The distance from the outermost side of the radial axis sector to the axis center. The value is the proportion of the component height. The value ranges from 0 to 1.
      Inner radius	The distance from the innermost side of the radial axis sector to the axis center. The value is the proportion of the component height. The value ranges from 0 to 1.

    • Display: If the switch is turned on, the radial axis pattern of the component is visible. If the switch is turned off, the radial axis pattern of the component is invisible.

    • Scale Quantity: the number of scales on the inner radial axis of the assembly.

    • Scale Optimization: If you turn on the switch, the inner radial axis of the component is automatically optimized. If you turn off the switch, you must specify the maximum and minimum values for the inner radial axis of the component.

    • Axis Label: the label style of the radial axis. You can click the icon to display or hide the label.

      Parameter	Description
      Display Format	The display format of the radial axis label. Valid values: Original, 11 (integer), 11.1 (floating point), and 11.11 (floating point).
      Label Offset	The up and down displacement distance of the radial axis axis label, in px.
      Text	The font size, text weight, color, and alignment style of the radial axis label text.

    • Grid: the style of the radial axis grid lines. You can click the icon to control the visibility of the radial axis grid lines.

      Parameter	Description
      Color	The color of the radial axis grid lines.
      Width	The width value of the radial axis grid line.
      Linetype	The shape of the radial axis grid line. You can select Solid, Dashed, or Dotted.

    • Axis: the style of the radial axis. You can click the icon to control the visibility of the radial axis.

      Parameter	Description
      Color	The color of the radial shaft axis.
      Width	The value of the width of the radial shaft axis.
      Linetype	The line shape of the radial axis. You can select solid, dashed, or dotted.

    • Tick Mark: the style of the radial axis tick mark. You can click the icon to show or hide the radial axis tick mark.

      Parameter	Description
      Color	The color of the radial axis tick marks.
      Linetype	The line shape of the scale mark on the radial axis. Valid values: Solid, Dashed, and Dotted.
      Width	The value for the width of the radial axis tick marks.
      Length	The length value of the radial axis tick marks.

  • Angle Axis: the style of the angle axis.

    Angle: the values of the start and end angles of the chart.

• Sector

  Sectors: Click the or icon on the right to add or delete a sector data series. Click the or icon on the right to configure the arrangement style of multiple sectors. Click the icon to copy the selected data series configuration and add a data series with the same configuration.

  Slice Style: the color of the pie chart.

• 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.
    Entry Animation Duration	The duration of the first animation rendered by the component. Unit: ms.
    Update the animation duration	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 mouse over or click a sector on a preview or publish page. You can click the icon to turn the dialog box effect on or off.

    Parameter	Description
    Name	Turning on the switch dialog box display the name of the current sector; turning off the switch dialog box not display the name of the sector.
    Show Percentage	Turn on the switch to dialog box display the percentage value of the current sector; turn off the switch to dialog box not display the percentage value of the sector.
    Guide Line	dialog box the style of the leader line. Length: the length of the guide line. Valid values: 0 to 1. Width: the width of the guide line. Color: the color of the guide line.
    Text	The font size and color of the text in the dialog box.

Data dashboard

Interactive Panel

Select the Enable check box to enable interactions between widgets. When a polar area chart sector block is clicked, a data request is triggered, a callback value is thrown, and data of different sectors is dynamically loaded. By default, the name and value values in the data are 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 polar area chart in the Added Nodes pane. You can view the polar area chart parameters in the canvas, as shown in the following figure.

   • Event

     Event	Description
     When the polar area chart interface description request completes	The event that is returned when the data interface request is completed and is processed by the filter. The event also throws the processed JSON-formatted data. 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 the polar area chart interface description request fails	The event that is returned when a data interface request fails (such as network problems or interface errors) and is processed by the filter. The event also throws the processed JSON data. 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 polar area chart sector block is clicked, along with the data item corresponding to that sector.

   • Action

     Action	Description
     Request polar area chart Interface Description	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, polar area chart the API data source is https://api.test and the data passed to the Request polar area chart API Description action is { id: '1'}, the final request interface is https://api.test?id=1.
     Import polar area 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.