DataV:The 3D Circular Bar

Chart Style

A 3D circle chart is a type of pie chart, which can clearly and intelligently display the proportion of each category in the circle. 3D ring charts support label display at multiple locations inside and outside the chart, support indicator card display style display, and support custom multi-series data configuration.

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.

• Size: indicates the size of a widget, including its pixel width and height. You can click the icon to lock the aspect ratio of the widget and modify the width and height of the widget in equal proportion. 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 icon to control the rotation angle of the widget.

  • Click the icon to flip the widget style.

  • Click the icon to flip the widget style.

• Opacity: Valid values: 0 to 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.

• Graphics

  • Projection Mode: the projection mode of the 3D loop. Valid values: Perspective Projection and Orthogonal Projection.

  • Visual Distance: the visual distance of the 3D view of the ring. It is used to adjust the overall size of the ring. Unit: px.

  • Rotation Angle: the angle between horizontal rotation and vertical rotation. Click the icon to control the display of the rotation angle.

    Note

    When the rotation angle is turned on, it has an effect on rotation in mouse interactions.

  • Inner /Outer Diameter Ratio: Drag the slider to set the inner /outer diameter ratio of the loop graph.

  • Height Mapping: specifies the height mapping of the 3D loop. When the height mapping switch is turned on, the height of each part of the loop is mapped based on the value in the data. When the height mapping switch is turned off, the height of each part of the loop is equal.

  • Height Scale: the height scale of the 3D loop.

  • Color: Set the color of the 3D circle.

  • Decimal Merge: Limits the number of slices to be displayed and merges the remaining slices into a total slice. You can also set the name of the merged category. Click the icon to turn decimal consolidation on or off.

  • Ring Chart Labeling: the labeling style of the ring chart. Click the icon to control the configuration items of the ring chart label.

    Parameter	description
    Type	The data type and display type of the annotation. Valid values: Percentage and Default. Valid values: Common and Spider. Note If the number of data entries exceeds three, we recommend that you change the value of the Display Type parameter to Standard.
    Labeling Field	The label field of the ring diagram. Valuable values include name+value, name, and value.
    Delimiter	Set the delimiter of the ring icon column. Enter br to break a line. This parameter can be configured only when name+value is selected for the column field of the ring chart.
    Decimal Places	The decimal place of the label field. Unit: digits.
    Row Height	The row height value of the label field. Unit: px. This parameter can be configured only when name+value is selected for the column field of the ring chart.
    Spacing	Set the distance between the label field and the ring chart. The unit is px.
    Text Style	The text style of the column field, including the font style, text weight, font size, and color.

• Animation: the animation style of the 3D loop.

  • Auto Rotate: If you turn on the switch, the ring diagram automatically rotates. If you turn off the switch, the ring diagram does not rotate.

    Note

    You can set the Auto Rotate parameter to Normal.

  • Rotation Direction: Set the rotation direction of the 3D loop. You can select counterclockwise or clockwise. This parameter is available only when you turn on Auto Rotate.

  • Rotation Speed: the rotation speed of the 3D loop. This parameter is available only when you turn on Auto Rotation.

• Interaction

  • Mouse Interaction: You can perform multiple mouse operations to rotate, zoom, and zoom in or zoom in. The Rotate and Zoom operations are supported only when the annotation type is set to Normal.

  • dialog box: On the preview or publish page, the style of the dialog box that appears when you move the pointer over or click the ring chart. Click the icon to control the display and concealment of the dialog box configuration items.

    Parameter	description
    Trigger Method	The method by which the dialog box is triggered. You can select Hover or Click.
    Display Position	The position style of the dialog box display. The value is optional, including top, bottom, left, and right.
    Title Spacing	The spacing between titles in the dialog box. Unit: px.
    Title Text	The style of the title text in the dialog box, including the font style, weight, font size, and color.
    Content Text	The style of the content text in the dialog box, including the font style, text weight, font size, and color.
    Pop-up background	dialog box pop-up background style. Background Margin: dialog box the horizontal and vertical margins of the pop-up background. Background Color: The background color of the dialog box. Border Style: the style of the dialog box border, including the width and color of the border lines.

• Legend: the legend style of the ring chart.

  Parameter	description
  Legend Switch	If you turn on the switch, you can configure the legend style. If you turn off the switch, you cannot configure the legend style.
  Direction	The orientation of the legend. You can select Horizontal or Vertical.
  Horizontal Alignment	The horizontal alignment style of the legend. You can select Left, Center, or Right.
  Vertical Alignment	The alignment style of the legend in the vertical direction. You can select Top, Center, or Bottom.
  Text Style	The font style, text weight, font size, and color of the legend text.
  Category Legend	The style of the sub-type legend. Legend Marker: the size and shape of the legend marker. Legend Spacing: the horizontal and vertical distance between the legends of different categories.
  Allow Page Turning	Turn on the switch to turn the legend page feature. You can configure the page number style and arrow style when the number of legends is too large. If you turn off the switch, all the legend content is displayed on one page and cannot be turned. Page Style: the style of the page number, including the font, weight, font size, and color of the page number. Arrow Style: the size, default color, and disabled color of the arrows in the page-turning style.

• Effects: displays the effects of 3D graphics.

  Parameter	Description
  Light and Shade	Optional. Valid values: Color Only and Shading.
  Lighting effect	This parameter is displayed when you select Shadows Shadows. Main light: Set the main light intensity, light color, horizontal and vertical rotation, projection and shadow quality. Ambient Light: Set the light intensity and color of the primary light source.
  Late Effect	Sets the post effect of 3D graphics. Highlights: Sets the glow intensity of highlights in Post Effects. Depth of Field: Sets the size of the depth of field in the post effect and the blur radius.

• Condition: the description of the condition style.

  Conditional Style: Click the or icon to add or remove a conditional style. Click the or icon to configure the arrangement style of multiple conditional styles. Click the icon to copy the current conditional style configuration and add a conditional style with the same configuration.

  Fan Color: If you turn on the switch, you cannot configure the fan color of the condition. If you turn off the switch, you cannot configure the fan color of the condition.

Data panel

Configuration field description

Interactive Panel

Description

Configure interactions in Blueprint Editor

1. In Canvas Editor, right-click a widget in the Layer panel and select Add to Blueprint Editor.

2. Click the icon in the upper-left corner.

3. In Blueprint Editor, click the 3D Rings widget in the Import Nodes pane. You can view the parameters in the canvas, as shown in the following figure.

   • Event

     Events	Description
     when the 3d loop interface 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 the 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 you click the ring chart	The event that is raised when the ring block of the 3D ring graph is clicked, and the data item corresponding to the sector is also raised.
     When the legend is clicked	The event that is raised when the legend of a 3D ring chart is clicked, and the corresponding data item of the legend is also raised.

   • Action

     Action	Description
     Request a 3d ring diagram	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 transferred to the request 3D loop interface is { id: '1'}, the final request interface is https://api.test?id=1.
     Import a 3D ring diagram	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.
     Update component configurations	Style configurations of widgets are dynamically updated. In the Configuration panel, click Copy Configuration to Clipboard to obtain the configuration data of the component. After that, change the style field for the data processing node in Blueprint Editor.
     Display	The following example shows the widget. return{ "animationType": "", "animationDuration": 1000, "animationEasing": "linear" }
     Hide	The following example shows the widget. return{ "animationType": "", "animationDuration": 1000, "animationEasing": "linear" }
     Switch to the implicit state	The following example shows whether to show or hide a widget. return { "animationIn": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" }, "animationOut": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" } }
     Move	Move a widget to a specified location. The following example shows the reference data. return{ // 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 duration in which animation is displayed. "animationDuration": 1000, // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. "animationEasing": "linear" } }