All Products
Search

This Product

    DataV:Doughnut layer

    Document Center

    DataV:Doughnut layer

    Last Updated:Dec 06, 2024

    This article describes the meaning of each configuration items of the donut layer.

    Chart style

    The donut layer is a sub-component of the 3D earth and supports independent style configurations, including the radius, size color, and dialog box configuration of the donut. image.png

    Style Panel image.png

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

    • Minimum Radius: the inner radius of the doughnut layer.

    • Max Radius: the value of the outer radius of the doughnut layer.

    • Donut Size: The size of the donut layer.

    • Outer Ring Color: the color of the outer ring of the donut layer.

    • Inner Render Mode: the color rendering mode of the inner circle of the donut layer, including Monochrome and Gradient.

    • Start Color and End Color: the start color and end color of the doughnut. This configuration items is displayed only when you select Gradient for Inner Render Mode.

    • Inner Color: the color of the inner circle of the doughnut layer. This configuration items is displayed only when Inner Render Mode is set to Monochrome.

    • dialog box Configuration: The style of the dialog box that appears when you move over or click a donut on a preview or publish page.

      Metric

      description

      Background Color

      The background color of the dialog box.

      Font

      The font style of the text in the dialog box.

      The color of the font. For more information, see Color setting parameters.

      dialog box the color of the font.

      Font Size

      dialog box the size of the font.

    • Series: Click the imageor imageicon to add or delete a scatter series. Click the imageor imageicon to configure the arrangement style of multiple scatter series. Click the imageicon to copy the currently selected scatter pattern configuration and add a scatter pattern with the same configuration.

      Metric

      description

      Key Name

      The field name of the scatter class, which matches the corresponding series field in the donut field on the data panel.

      Color

      The color of this scatter class.

    Data Sources panel image.png

    Column

    Description

    lng

    The longitude of the center point of the donut.

    lat

    The latitude of the donut's center point.

    inner

    The value of the donut's inner circle.

    outer

    The value of the donut's outer circle.

    donut

    The data of the ring chart. The data field matches the field name in the Series Configuration section.

    Configure data items

    Description

    Data sources

    You can use the code editor or visual editor to view the data fields contained in the widget. You can also modify the data type to flexibly configure the component data.

    Data Mapping

    If you need to customize chart field configurations, you can set different field mapping content in the Data Mapping module and field mapping these content to the corresponding fields of the widget. This allows you to match data without modifying the fields in the data source. You can also click the imageicon to configure the field style.

    Configure a filter

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

    Data Response Result

    The Data Response Result section displays widget data in real time. If the data source of the widget changes, this section displays the latest data. If the system response is delayed, you can click the imageicon on the right to view the data response result. You can also click the imageicon on the right to obtain the latest data of the widget. You can also click View Example to view an example of the response result of the current component.

    Forbid Loading

    If you select the check box, you will not see the loaded content during component initialization when you update the component and preview the data kanban. If you select the check box, the opposite is true. By default, the status is deselected.

    Controlled Mode

    If you select the check box, the component does not request data in the initialized state, and only requests data by using global variables or the method configured in Blueprint Editor. If you clear the check box, you can use automatic update to request data. By default, the status is deselected.

    Auto Data Request

    Select the check box to manually enter the time frequency of polling to set dynamic polling. If you clear the page, the page is not automatically updated. You need to manually refresh the page or use Blueprint Editor and global variable events to trigger a request to update data.

    Advanced Panel image.png

    Turn on the switch to enable the widget interaction feature. When a donut is clicked, a data request is triggered to throw a temporary variable to dynamically load data for different donuts. By default, the lng and lat values in the data are thrown. For more information, see Component interaction configuration.

    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 data 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 Source tab in the right-side configuration panel of the canvas editor.

        Donut is triggered by clicking

        An event that fires when a donut is clicked, while throwing the corresponding data item for that donut.

      • Action

        Action

        Description

        Request Data Interface

        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 doughnut layer configures the API data source as https://api.test and the data passed to the request data interface as { id: '1'}, the final request interface is https://api.test?id=1.

        Import data

        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 Source tab in the right-side configuration panel of the canvas editor.

        Switch Display /Hide

        Specifies whether to show or hide a widget. No parameters are required.

        Display

        Display the widget. For more information, see Data example. 

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

        Hide

        Hide the component. For more information, see Data example. 

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

        Update component configurations

        Style configurations of widgets are dynamically updated. In the Style panel, click Copy Configuration to Clipboard to obtain the configuration data of the widget. After that, change the style field for the data processing node in Blueprint Editor.