LineChart

Version: 9.0

The LineChart control displays a line chart. A line chart displays information as a series of data points connected by straight-line segments.

The LineChart control supports multi-axis charts. A multi-axis chart is a line chart that plots different values against the same category. Because each line in a multi-axis line chart is a different category, there is an axis for each value. The LineChart control shows a multi-axis line chart if you point it to a folder with multiple ChartField items in the ValueChartFields property.

You can specify in the ChartField items whether the LineChart control displays the axis for the value on the left or the right side of the chart.

The LineChart control supports multiseries charts.

The LineChart control supports displaying a sequence of charts when the data it receives from the data provider contains multiple data sets.

Note

A multiseries chart is a chart that shows multiple data series. For example: conversion rate, visitors, and bounce rate.

Multiple data sets means that the data contains multiple complete and discrete data sets.

Properties

Name	Description	Default
Appearance
DisableSelection	If true, the control does not allow chart items to be selected.	False
EnableAnimation	If true, the control uses animations.	False
ShowAxis	If true, the control displays axes.	True
ShowLegend	If true, the control displays a legend for the chart.	True
ShowValues	If true, the control displays the values of the data points inside the graph itself.	False
SingleChartHeight	Specify the height in pixels of the chart. If the chart is part of a sequence of charts, the control gives each individual chart this height.	400
SingleChartWidth	If you specify `100%`, the chart takes up the available width. If you specify a number, the control gives the chart this width in pixels. If the chart is part of a sequence of charts, `100%` means each chart has the entire available width, and the chart sequence becomes a vertical sequence. If the chart is part of a sequence of charts, and you specify an integer, the control gives each chart this width in pixels, and the sequence of charts wraps horizontally.	100%
VisibleCategoriesRange	If this number is > `0`, the control displays this number of categories along the horizontal axis. If the data contains more categories, users have to scroll horizontally. If this number is `0`, the control displays all categories.	0
Data
Data	Bind the control to the data it uses, for example: `{Binding.DataProvider.Data}`
DataMapping
CategoryChartField	Point to a ChartField item. The control uses this field as the X (horizontal) axis of the chart.
CategoryFilter	Specify one or more values like this: `{value1,value2}`. The control uses each of these values to filter the data column the CategoryChartField property points to.
SeriesChartField	Point to a ChartField item. The control uses this field as the definition of the series it shows.
SeriesFilter	Specify one or more values like this: `{value1,value2}`. The control uses each of these values as a facet of the data column the SeriesChartField property points to. If you do not enter anything, the control creates a facet for each distinct value in the data column.
ValueChartFields	Point to a ChartField item. The control uses this field as the Y (vertical) axis of the chart. You can specify multiple ChartField items as a comma-separated list. The LineChart control displays a graph and an axis for each value.

Configuration

You can create a configuration item for a LineChart control by creating an item based on the LineChart Parameters template.

The configuration item has these inherited fields:

ShowAxis
ValueChartFields
SingleChartWidth
CategoryChartField
ShowLegend
Data
ShowValues
CategoryFilter
SingleChartHeight
IsVisible
AccessKey
Tooltip
Behaviors
Id
VisibleCategoriesRange
SeriesChartField
SeriesFilter

Do you have some feedback for us?

If you have suggestions for improving this article,