Line Chart

A category line chart connects each (category, value) data item using straight lines.

Public Variables (Properties)

[?]

Common component variables and variable groups: Name, Visible, Breakpoints, Variable Storage, Container Properties, Styles, Preloader, Events, Component Bindings.

Common chart variables and variable groups: Common Properties, Legend, Zoom, X and Y Axes, Coordinate Grid, Tooltip, Visualization: Basic Properties, Visualization: Line and Visualization: Point.

Data

The Data properties group includes properties for Building Chart Datasets that are common to most charts. The following properties are specific to the Line Chart.

Source Data

The source data table used for building custom-data-based charts.

Variable Name:

sourceData

Records:

0…unlimited

Record Format:

Field Name

Field Type

Field Description

series

String

Series with which to group the data.

category

String

Category, analogous to the X value of the data point.

value

Double

Value of the data, analogous to the y value.

Source Data Bindings

A set of expressions used to retrieve data from Source Data's records and build the resulting chart dataset. This property is also valid only for charts based on custom data.

Variable Name:

dataBindings

Records:

1

Record Format:

Field Name

Field Type

Field Description

series

String

Expression to define the Series of the chart dataset, with the following Resolution Environment:

Default Context

Specified by the series Context setting.

Default Data Table

Value of variable specified by the Source Data table.

Default Row

0 (or dynamic if series propagation is enabled)

Environment Variables

Standard variables only.

category

String

Expression to define the Category of the chart dataset, with the following Resolution Environment:

Default Context

Specified by series Context setting.

Default Data Table

Value specified by the Source Data table.

Default Row

0 (or dynamic if series propagation is enabled)

Environment Variables

Standard variables only.

value

String

Expression to define the Value of the chart dataset, with the following Resolution Environment:

Default Context

Specified by series Context setting.

Default Data Table

Value specified by the Source Data table.

Default Row

0 (or dynamic if series propagation is enabled)

Environment Variables

Standard variables only.

Auto Load Dataset

When true, the chart will be redrawn whenever any parameter in the data group is changed. By setting it to false, the chart will redraw only when the updateDataset() function is called in the chart context.

Variable Name:

autoLoadDataset

Records:

1

Record Format:

Field Name

Field Type

Field Description

autoLoadDataset

Boolean

Auto Load Dataset

Compress Ratio

Multiplies all Y values in a series by the indicated value in order to expand or compress the chart display. Does not affect values displayed in the tooltip.

Variable Name:

compressRatios

Records:

1

Record Format:

Field Name

Field Type

Field Description

compressRatioSeries

String

Series

compressRatioValue

Double

Value

Visualization: Basic Properties

In addition to the common Visualization Basic Properties, the Line Chart has the following unique Visualization properties.

Render as Stack

When enabled, the areas defined by each data series will be stacked. When disabled, areas will overlap.

Variable Name:

renderAsStack

Records:

1

Record Format:

Field Name

Field Type

Field Description

renderAsStack

Boolean

Render as Stack

Disable Dots

Hides the dots indicating the data points defining the line.

Variable Name:

disableDots

Records:

1

Record Format:

Field Name

Field Type

Field Description

disableDots

Boolean

Disable Dots

Smooth

Smooth the graph lines at each point.

Variable Name:

smooth

Records:

1

Record Format:

Field Name

Field Type

Field Description

smooth

Boolean

Smooth the graph lines at each point.

Pass Null

Visualization method in cases where the Value field of Source Data is Null, but Category and Series are defined, in one or more rows. The following options are available, with the indicated visualization behaviour:

  • Pass - Data points will only be connected to data points of the immediately preceding or immediately following category. In the case of one or more points with a Null Value in the data set, the chart line will be discontinuous.

  • Line - Each data point will be connected by a solid line to the data point of the following or preceding category with a non-Null Value, creating a continuous chart line.

  • Dotted - Similar to Line, except connecting lines which pass over one or more Null values will be displayed as a dotted line.

Variable Name:

passNullsType

Records:

1

Record Format:

Field Name

Field Type

Field Description

passNullType

String

Pass Null

Multiple Axis

In addition to the common Visualization Basic Properties, the Line Chart has the unique Multiple Axis property.

Multiple Axis

Multiple Axis allows you to add additional Y-axes to the chart. Each row adds a Y-axis specific to the series named in the Series field. Definitions for each of the fields displayed in the Axis Title, Axis Label, Axis Line, Axis Tick, and Axis Grid data tables correspond to the similarly named fields under Y Axis Properties.

Variable Name:

multipleAxis

Records:

0…Unlimited

Record Format:

Field Name

Field Type

Field Description

series

String

Series

position

String

Position

axisTitle

Data Table

Axis Title

axisLabel

Data Table

Axis Label

axisLine

Data Table

Axis Line

axisTick

Data Table

Axis Tick

axisGrid

Data Table

Axis Grid

Public Events

[?]

Common Events: Common Component Events, Changing Chart Zoom

Was this page helpful?