All Products
Search
Document Center

DataV:radio-buttons

Last Updated:Dec 03, 2024

This article describes the meaning of each configuration items when selecting all quantities in a radio box.

Chart style

A radio box is a type of control widget that can be used as a radio selection form in a visualization application to submit the data selected by the user to the backend for processing. Or display user-selected content on other components through interactive configuration. 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.

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

    • Positioning: the x-axis and y-axis of the component. Unit: pixels. 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.

    • Rotate: The widget is rotated around the center of the widget. Unit: degrees.

      • 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.

      • Click the imageicon to flip the widget style.

      • Click the imageicon 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.

  • Global Style

    Parameter

    Description

    Selected by Default

    The option selected by default.

    Note

    By default, the selected content must be selected within the value value in the data source configuration.

    Arrangement

    The type of the radio box. Valic options: Vertical and Horizontal.

    Button radius

    Radius size value of the radio button.

    Spacing

    The spacing style of the options. You can configure Inter-Option Spacing and Intra-Option Spacing.

    • Spacing Between Options: the distance between options.

    • Spacing Within Option: the distance between the radio button and the text.

  • Normal Style

    • Text Style

      Parameter

      Description

      Font

      The font style of the text. Default value: Microsoft Black.

      Text weight

      The font weight of texts in a text box.

      Font size

      The text font size.

      Color

      Please refer to the color picker description to modify the color of the text in the radio box.

    • Button Style

      Parameter

      Description

      Background color

      The background color of the radio button.

      Borders

      The border style of the button, including the border width, border color, border corner size value, and line type style.

  • Selected Style: the style of the radio box that is selected.

    • Text Style

      Parameter

      Description

      Font

      The font style of the text when the radio box is selected. Default value: Microsoft Black.

      Text weight

      The text font weight when the radio box is selected.

      Font size

      The size of the text font when the radio box is selected.

      Color

      The color of the text when the radio box is selected, please refer to the color picker description to modify.

    • Button Outer Circle Style

      Parameter

      Description

      Background color

      The background color of the outer circle of the button when the radio box is selected.

      Shadow Color

      The shadow color of the outer circle of the button when the radio box is selected.

      Border Style

      When the radio box is selected, the border style of the button, including the border width, border color, border rounded corner size value, and line type style.

    • Button Internal Style

      Parameter

      Description

      Background color

      The color of the background inside the button when the radio box is selected.

      Border Fillet

      The rounded border of the button when the radio box is selected. Valid values: 0 to 360. When the value is 0, the inner border of the button is square, and when the value is 360, it is round.

Data Sources panel image.png

Parameter

Description

value

The content displayed by each button in the radio box.

disabled

Whether each button in the radio box is set to disabled.

Note

Once the disabled field of a button is configured as true, you cannot click to select this option in the preview or publish page.

Configure data items

Notes

DataSource

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 parameter 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 associated global variable feature. You can trigger a data request and throw a temporary variable when you click the radio box. The temporary variable can be configured and used in other components. By default, the value and disabled values configured in the Data Source panel are displayed. 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

    • Event

      Event

      Notes

      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.

      When the radio button is clicked

      The event that is raised when a radio button is clicked, and the data item corresponding to the value is also raised. For more information, see the data example.

      {
        "value": "A",
        "disabled": true
      }
    • Action

      Action

      Notes

      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, see the data example.

      {
        "value": "A",
        "disabled": true
      }

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

      Set the value of the current radio box

      Set the value selected in the current radio box. For more information, see the data example.

      {
        "value": "A"
      }

      Obtain the current value

      You can call this operation to obtain the value in the current radio box. No parameters are required.

      Clear a component to its default value

      Restores the component to the value selected by default. No parameters are required.

      Move

      Move a widget to a specified location. For more information, see the 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 duration in which animation is displayed. 
              "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

      Display the widget. For more information, see 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

      Hide the component. For more information, see 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

      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.