Updated: May 6, 2020

Column Micro Chart

sap.suite.ui.microchart.ColumnMicroChart

Intro

A column chart uses vertical bars to compare multiple values over time or across categories. One axis of the chart shows the categories being compared, the other axis represents a value. The bars of the column micro chart can represent both positive and negative values.

There are three main ways to visualize a column micro chart:

  • View with top labels for start and end values, and bottom labels for start and end dates
  • Detail view with labels for each vertical bar. This view can be used only if there is enough space for enough bars width in the container.
  • No labels. In all cases, the label can be switched off.

You can use either the semantic chart palette or the qualitative chart palette.

Column micro chart with top labels for start and end values, and bottom labels for start and end dates
Column micro chart with top labels for start and end values, and bottom labels for start and end dates
Column micro chart without labels, using semantic colors
Column micro chart without labels, using semantic colors
Column micro chart without labels, using qualitative colors
Column micro chart without labels, using qualitative colors

Usage

The column micro chart can be embedded into a tablelisttile, or header.

Use the column micro chart if:

  • You want to visualize a trend.
  • You want to compare multiple values over time or across categories.

Do not use the column micro chart if:

  • You have a scenario that does not require a comparison over time.

Responsiveness

The column micro chart is fully responsive. The size adjusts dynamically based on the dimensions of the parent container. In addition, there are four fixed sizes: L, M, S and XS. Each fixed size is a snapshot of the fully responsive micro chart for specific dimensions.

Column micro chart - Size L
Column micro chart - Size L
Column micro chart - Size M
Column micro chart - Size M
Column micro chart - Size S
Column micro chart - Size S
Column micro chart - Size XS
Column micro chart - Size XS

You can use size XS to embed the column micro chart in the cells of a grid tableanalytical table, or tree table (also in condensed mode). Left-align the column micro chart in the table cell.

Column micro chart in size XS in a grid table
Column micro chart in size XS in a grid table

Maximum and Minimum Sizes

The column micro chart can have the following dimensions:

Width Height
Maximum 320 px 94 px
Minimum 64 px 18 px

If the chart height is less than 72 px, the column labels are hidden. Instead, the chart switches to the standard view, and shows the start and end values per chart, as well as start and end dates.

If the chart height is less than 56 px, all labels are hidden.

Components

Bars

The bars of the column micro chart can represent both positive and negative values.

We strongly recommend using only colours from the semantic palette for the bars (good, critical, bad, neutral). If your use case requires colours from the qualitative palette, use only one colour per chart.

Top and Bottom Labels

The labels for the column 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. The responsive behaviour of the chart hides labels if there is not enough space to display them (for XS size and smaller or if If the chart height is less than 56 px). Ensure that the labels for the values are not truncated.

Bar Labels

For a more detailed view of the chart, you can use bar labels. The bar labels are displayed only if the container is wide enough to accommodate a minimum number of bars. The bars must be at least as wide as the label. Otherwise, the responsive behavior of the chart automatically switches to the mode with only top and bottom labels displayed. Ensure that the labels for the values are not truncated.

Column micro chart - Components
Column micro chart - Components

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