arc-column-charts

更新时间:
复制 MD 格式

Chart style

An arc column chart is a type of column chart in the mobile component. Compared with the basic column chart, an arc column chart can more intuitively display the differences between a variety of data in a limited screen space. image

Configuration Panel image

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

  • Chart name

    • Custom Margins: the distance between the column chart area and the four boundaries of the widget. The default unit is px. You can click the 眼睛图标icon to specify whether to use custom margins.

    • Series Spacing: the ratio of the distance between column chart in each series. Valid values: 0 to 1.

    • Legend: the legend style of the arc column 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: Round and Square.

      Text

      The text style of the legend.

      • Font Size: the size of the legend text.

      • Text weight: the weight of the legend text.

      • Color: the color of the legend text.

      • Alignment: the alignment of the legend text. You can select Center, Left, or Right.

  • Coordinate Axis: You can select Radial Axis or Angular Axis.

    • Radial axis

      • Radius

        Parameter

        Description

        Outer radius

        The distance from the outermost side of the ring to the center of the axis. The value is the proportion of the component height. Valid values: 0 to 1.

        Inner radius

        The distance from the innermost side of the ring to the center of the axis. 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.

      • Type: the type of radial axis data. Valid values: Category and Time.

        Note

        If the data format and specified data types are not consistent, the widget is displayed abnormally.

        Parameter

        Description

        Category Type

        Data of category types such as character and string is supported.

        Time Type

        The data of the time type needs to be configured data format.

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

      • Leave White: the ratio of the space between the two ends of the radial axis. Valid values: 0 to 1.

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

        Parameter

        Description

        Display Format

        The display format of the data. This field is valid only when the data type is Time.

        Label Offset

        The up and down displacement distance of the radial axis label, in px.

        Text

        The font size, text weight, color, and alignment 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

        Type

        The type of the grid line. Valid value: Arc Grid and Line Grid.

        Mode

        The style of the radial axis grid line, including the color, width, and shape of the grid line. You can select Solid, Dashed, or Dotted.

      • Axis: the style of the radial axis. You can click 眼睛图标the icon to control the visualization 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

      • Angle: the start and end angles of the widget.

      • Display: If you turn on the switch, the angle axis style in the widget is visible. If you turn off the switch, the angle axis style in the widget is invisible.

      • Number of Scales: the number of scales on the angle axis of the widget.

      • Scale Optimization: If you turn on the switch, the scale of the angle axis in the widget is automatically optimized. If you turn off the switch, you must specify the maximum and minimum values for the angle axis in the widget.

      • Leave White: the ratio of blank spaces between the two ends of the angle axis. Valid values: 0 to 1.

      • Axis Label: the style of the axis label of the widget. You can click the 眼睛图标icon to display or hide the axis label.

        Parameter

        Description

        Display Format

        The display format of the angle axis label. Valid values: Original, 11 (integer), 11.1 (floating point), and 11.11 (floating point).

        Label Offset

        The up-down displacement distance of the angle axis label. Unit: px.

        Text

        The font size, text weight, color, and alignment style of the angle axis label text.

      • Grid: the style of the grid lines on the angle axis. You can click the 眼睛图标icon to specify whether to display the grid lines on the angle axis.

        Parameter

        Description

        Color

        The color of the angle axis grid lines.

        Width

        The width value of the angle axis grid line.

        Linetype

        The shape of the angle axis grid line. You can select Solid, Dashed, or Dotted.

      • Axis: the style of the angle axis. You can click the 眼睛图标icon to display the angle axis.

        Parameter

        Description

        Color

        The color of the angle shaft axis.

        Width

        The width value of the angle shaft axis.

        Linetype

        The line shape of the angle axis. Valid values: Solid, Dashed, and Dotted.

      • Tick mark: the style of the tick mark on the angle axis. You can click the 眼睛图标icon to display the tick mark on the angle axis.

        Parameter

        Description

        Color

        The color of the angle axis tick marks.

        Linetype

        The line shape of the scale mark on the angle axis. You can select solid lines, dashed lines, or dotted lines.

        Width

        The width value of the angle axis tick marks.

        Length

        The length value of the angle axis tick marks.

  • Edition

    data series: Click the 加号图标or 垃圾桶图标icon on the right to add or delete a data series. Click the 横向排列图标or 竖向排列图标icon on the right to configure the arrangement style of multiple data series. Click the 复制图标icon to copy the selected data series configuration and add a data series with the same configuration.

    Column Style: the style of the column in the series.

    Parameter

    Description

    Color

    The color of the column.

    Width

    The width value of the column.

  • 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 column on a preview or publish page. You can click 眼睛图标the icon to turn the dialog box effect on or off.

      Parameter

      Description

      Series Name

      dialog box the font size and name color of the displayed series names.

      Value

      dialog box the font size and color of the displayed values.

      Background Box

      The background box style of the dialog box.

      • Fillet: the fillet size of the dialog box background frame. Unit: pixels. When the value is 0, there is no rounded corner, and the background box is square. The larger the setting value, the larger the radian value of the rounded corner.

      • Color: The background color of the dialog box.

Data dashboard

image

Column

Description

x

The content of the field on the radial axis corresponding to the start point of each bar chart. The content type and format of this field must be consistent with the type of radial axis in the configuration items.

y

Corresponds to each bar chart field value on the angle axis.

s

(Optional) The series value.

Parameter

Description

Controlled Mode

If you turn on the switch, data is not requested when a widget is initialized. Data requests are triggered only based on callback IDs or the method configured in Blueprint Editor. If you turn off the switch, data requests are automatically triggered. By default, the switch is turned off.

Auto Data Request

After you select the Auto Data Request check box, you can enable dynamic polling, and manually specify the polling interval. If you clear the check box, the data is not automatically updated. You must manually refresh the page or use the Blueprint Editor and callback ID events to trigger a request to update the data.

Data source

Click Configure Data Source. In the Configure Data Source panel, modify the data source type and query code, preview the response of the data source, and view the response results. For more information, see Configure a component data source.

Data Filter

If you select the Data Filter check box, you can convert the data structure, filter data, and perform simple calculations. Click Add Filter. In the Set Data Source panel, configure a data filter script. For more information, see Use a data filter.

Data Response Result

The response to a data request. If the data source changes, you can click the 刷新图标 icon on the right to view the response results in real time.

Interactive Panel image

Select the Enable check box to enable interactions between widgets. When you click a column of an arc column chart, a data request is triggered, a callback value is thrown, and data of different columns is dynamically loaded. By default, the x value in the data is 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 the Arc Column Chart widget in the Import Nodes pane. You can view the parameters of the Arc Column Chart widget on the canvas, as shown in the following figure. 圆弧柱形图蓝图参数

    • Event

      Event

      Description

      When the arc column chart interface description 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 arc column 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 column of the column chart is clicked, along with the data item corresponding to the column.

    • Action

      Action

      Description

      Description of the request arc column chart operation

      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 Arc Column Description action is { id: '1'}, the final request interface is https://api.test?id=1.

      Import Circular Column 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.