Updated: June 20, 2018

Line Micro Chart

sap.suite.ui.microchart.LineMicroChart

Intro

A line chart is a basic type of chart used in many fields. It displays information as a series of data points connected by a line. The chart is often used to visualize a trend over time.

The line micro chart can be embedded into the table, list, tile and header.

Usage

Use the line micro chart if:

You want to visualize the shape.

Use this option to show a trend or sparkline. By default, the chart will be rendered in blue, but application developers can set any color for the chart, either with the names of semantic colors or color names from the sequential palette.

Line micro chart - Sparkline
Line micro chart - Sparkline

You want to show data points which are above or below a certain threshold.

Use this option to show values which are above or below a certain threshold. Note that the threshold can be set at zero as well.

In addition to data points, you can use two different colors for the lines. We recommended that you use only semantic colors for this option, such as green for values above the threshold, and red for values below the threshold.

Line micro chart - Data points above and below a threshold
Line micro chart - Data points above and below a threshold

You want to show one or two focus points.

Use this option to display a trend or sparkline to focus on one or two special values, such as the first and/or last value of the chart. By default, the chart will be rendered in blue, but application developers can choose another color for the chart line and data points from the sequential palette.

Line micro chart - 2 focus points
Line micro chart - 2 focus points

You want to show one or two focus points with semantic colors.

Use this option to display a trend or sparkline to focus on one or two special values with semantic meaning, such as the first and/or last value above or below a certain threshold. Note that the threshold can be set to zero as well.

Line micro chart - 2 focus points with semantic meaning
Line micro chart - 2 focus points with semantic meaning

Do not use the line micro chart if:

You have scenarios that do not depict time periods.

Line micro chart in a tile or facet

The chart with all functionalities and options mentioned above can be embedded in a tile or header facet. It will use the full height and width of the control.

Note: The title of the tile or header facet should clearly express the value of the threshold if it is not equal to zero, such as values above and below 50.

Line micro chart in a tile with data points above and below the zero threshold
Line micro chart in a tile with data points above and below the zero threshold
Line micro chart (sparkline) in a tile with no semantic meaning
Line micro chart (sparkline) in a tile with no semantic meaning
Line micro chart (sparkline) in a tile with no semantic meaning
Line micro chart (sparkline) in a tile with no semantic meaning
Line micro chart in a tile with focus on first and last data point
Line micro chart in a tile with focus on first and last data point
Line micro chart in a tile with semantic focus point and KPI value
Line micro chart in a tile with semantic focus point and KPI value

Line micro chart in a table or list

The chart with all functionalities and options mentioned above can be embedded in a table or list.

Please note: Use manual scale if you intend to synchronize the chart visualization.

Line micro chart in a table with values above and below a threshold
Line micro chart in a table with values above and below a threshold
Line micro chart in a table - Smaller size
Line micro chart in a table - Smaller size
Line micro chart in a table with 4 focus points - First/last and min/max value
Line micro chart in a table with 4 focus points - First/last and min/max value
Line micro chart in a table with data points hidden
Line micro chart in a table with data points hidden

Responsiveness

See the micro chart overview article.

Components

To present the line micro chart in an appealing way, application developers can set several properties.

Data points

The line micro chart can display or hide data points. To display data points, we recommend that you use 4 (for quarters) to 12 (for months) data points per chart. The responsive behavior of the chart will hide data points when there is not enough space to display them.

If data points are colored with a semantic meaning (such as green for positive, orange for critical, and red for negative values), the line will be colored grey.

If data points do not have a semantic meaning, application developers can assign any color from the sequential palette. Please note that the line will have this color as well.

As well, the chart can also be displayed as line only, with all data points hidden. Application developers can set up to two colors per chart for this option. We recommend that you use semantic colors for the line to highlight values above or below a certain threshold, for example.

Line micro chart - Data points
Line micro chart - Data points

Focus points

Unlike data points, focus points highlight specific values, such as the first and/or last value of a time series. Focus points can either be colored neutral blue, green, orange, or red if they contain a semantic meaning.
Focus points are always displayed regardless of the size of the chart.

Line micro chart - Focus points
Line micro chart - Focus points

Threshold line

You can set a threshold line. If the threshold doesn’t equal zero, include its value in the title of the tile, header facet, or column in lists and tables to ensure that the chart is not misleading for the user.

Line micro chart with threshold line
Line micro chart with threshold line

Labels

The labels for the line micro chart are optional. Use the bottom labels to indicate the beginning and the end of the time period. Use the top labels to show the corresponding values for the beginning and the end of the chart. Ensure that the labels for the values are not truncated.

Line micro chart with labels
Line micro chart with labels

Scale

Application developers can set the scale manually or automatically. If the threshold is included in the scale, the chart will always render a horizontal reference line.

Use auto scale for lists and tables if you want to display a trend/sparkline per list/table element independent from other list/table elements.

Use manual scale if list/table entries need to be synchronized. Entering the scale manually will ensure that all charts are comparable within the list/table.

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Implementation