China national border (v4.x)

Updated at:

Configure the style, data source, and blueprint interactions for the China national border sub-widget in Basic Flat Map 4.0.

Chart style

The China national border is a sub-widget of Basic Flat Map 4.0. You can configure its style, data, and interactions independently, including border appearance and geographic annotations.image

Style panel{7D181E7D-CB20-4C45-B362-7C09108E3071}

  • Search Configuration: Click the image icon in the upper-right corner of the Style panel to search for configuration items by name. Fuzzy matching is supported. Search for a configuration item.

  • General: General settings for the China national border.

    Parameter

    Description

    Visible Level

    The zoom level range in which the China national border is visible.

    Opacity

    The opacity of the China national border, ranging from 0 to 100%. A higher value makes the layer more opaque.

  • Graphic: Graphic settings for the China national border.

    Parameter

    Description

    Fill Color

    The fill color for areas within the China national border. For more information, see Use the color mapper to configure mapped color styles for area blocks in different country maps.

    Border Style

    The border style of the China map, including the color and range for national borders, provincial borders, and coastlines.

    Geographic Annotation

    The style of annotations at geographic locations on the China map, including annotation icon color and text style within the icon. Click the eye icon icon to the left of Geographic Annotation to show or hide the Geographic Annotation style.

    South China Sea Inset Map

    The style of the South China Sea inset map, including the background color, border style, right margin, bottom margin, and overall scale. Click the eye icon icon to the left of South China Sea Inset Map to show or hide the South China Sea Inset Map style settings.

  • Condition: The condition that determines which style to apply.

    Conditional Style: Click the image or image icon on the right to add or delete a conditional style. Click the image or image icon to arrange multiple conditional styles. Click the image icon to duplicate the selected conditional style configuration. For more information about style configurations, see Use the condition tree.

    Fill Color: The fill color of the China national border under the current condition. Click the Eye icon icon to the left of Fill Color to control its visibility.

Data Source panel{27AA8928-38BB-4E1B-A8A4-ED5CED87C86C}

Field

Description

adcode

The adcode of the area. You can obtain it from DataV.GeoAtlas.

name

(Optional) The name of the region.

colorField

(Optional) The color mapping field for the region.

Data Item Configuration

Description

Data Source

The component's data source displays the data fields contained within the component using code editing or visual editor. You can also modify the data type to flexibly configure the component's data.

Data Mapping

When you need to customize chart field configurations, you can set different field mappings in the Data Mapping module to map these fields to the corresponding fields of the component. This allows for real-time data matching without altering the data source fields. Additionally, click the image icon to configure field styles individually.

Filter

Open the Filter to select an existing data filter or create a new one, and configure the data filter script to achieve data filtering capabilities. For more information, see manage data filters.

Data Response Result

This feature displays the component's data in real-time. When the component's data source changes, the data response result will display the latest data accordingly. In case of a delayed system response, you can click the image icon on the right to check the current data response result, or click the image icon on the right to obtain the most recent data for the component. You can also click to view examples to see sample response results for the current component.

Disable Loading State

Check the check box to hide the loading content during component updates and data dashboard previews. Unchecking will display the loading content. The default setting is unchecked.

Controlled Mode

Check the check box to prevent data requests upon the component's initialization. Data requests will only be initiated through global variables or methods configured in the blueprint editor. Unchecking allows for automatic update requests. The default setting is unchecked.

Automatic Update Request

Check the check box to manually set the polling frequency for dynamic polling. Clearing this option disables automatic updates, requiring manual page refreshes or data request triggers through the blueprint editor and global variable events for updates.

Advanced panel

{4EFF154C-3E9D-4157-AE94-8AD5216EF9BC}

Configure interaction events or associate global variables for filter interactions between widgets. Configure widget interactions.

Blueprint interaction

  1. In the upper-left corner of the page, click the image icon to go to the Blueprint page.

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

  3. View the blueprint configuration parameters.image

    Note

    Click the image icon in the anchor point area on the right to view event and action parameter tooltips.

    • Events

      Event

      Description

      When data is updated

      Triggered after the data API response is returned and processed by the filter. Returns the processed data in JSON format. For a data example, see the Data Response section on the Data Source tab of the widget's configuration panel in the canvas editor.

      When the data request status changes

      Triggered when the data request status changes. The callback parameter is the current status. For a data example, see the Data Response section on the Data Source tab of the widget's configuration panel in the canvas editor.

      Component Loading Complete

      Triggered after a data API response is processed by a filter. Returns the processed data in JSON format. For a data example, see the Data Response Result area on the Data Source tab in the configuration panel for the widget in the canvas editor.

    • Actions

      Action

      Description

      Import data

      Processes data in the component's format and imports it to redraw the component without re-requesting server-side data. For a data example, see the Data Response area on the Data Source tab in the configuration panel to the right of the component in the canvas editor.

      Request data

      Re-requests server-side data, using output from an upstream data processing node or layer node as a parameter. For example, if a points heatmap layer has its API data source set to https://api.test and the data passed to the Request data action is { id: '1'}, the final request URL is https://api.test?id=1.

      Toggle visibility

      The Toggle Visibility, Show, and Hide actions do not require parameters by default. You can add animation configurations as needed. See the data example.

      {
        // Animation type. Optional values: appear|fade|slideToUp. The default is fade. If left blank, there is no animation.
        "animationType": "fade",
        // Animation duration. The default is 1000 ms.
        "animationDuration": 1000,
        // Animation curve. Optional values: linear|easeInOutQuad|easeInOutExpo. The default is linear.
        "animationEasing": "linear"
      }

      Show

      Hide

      Update component configuration

      Dynamically updates the component's style configuration. Click Copy Configuration to Clipboard on the component's Style panel to get the configuration data, then modify the field values in the data processing node on the blueprint editor's configuration page as needed.