Page History
(this page was created automatically. In case of formatting issues, please visit the official Wiki Page)
Line Chart
Link to Figma: tba
Overview
- The Dynamic Line Chart component displays data as lines on a chart.
- It is designed to visualize trends over time or relationships between data points.
- The chart supports multiple data series with customizable styling and configuration.
- Data can come from various sources, including APIs or mock data for testing.
- Custom axes, panes, and labels provide context for the information displayed.
...
- visibilityPolicySetId – Determines whether the chart is displayed based on a policy set. This allows showing the chart only to users with specific permissions. Example:
"dashboardViewerPolicy".
Links
- Figma: tba
- Live style guide: https://e1-dev.k8s.myapp.de/live-style-guide/other-components/line-chart
Guidelines
Usage
- Use for continuous trends or sequential categories configured via
chartConfiguration(maps the X-axis argument and Y-series). - Display multiple metrics in one view; distinguish them by naming each series in
chartConfiguration.series[].nameand enablingshowLegend. - Separate signals with different units/scales by defining vertical panes with
chartPanesConfiguration. - For demos or development, simulate data with
useMockData.
...
| Do | Don’t | Article setting(s) | |||
|---|---|---|---|---|---|
| Label axes with purpose and units (e.g., “Date”, “Sales (USD)”). | Leave axes unlabeled or rely on external context. | argumentAxisTitle, valueAxisTitle | |||
| Turn on the legend for multi-series charts and name each series. | Show multiple colored lines without labels or a legend. | showLegend, chartConfiguration.series[].name | |||
| Separate metrics with different scales into vertical panes. | Overlay vastly different ranges on one pane. | chartPanesConfiguration, chartConfiguration.series[] | |||
| Bind the X argument and Y values explicitly. | Depend on implicit or positional fields. | chartConfiguration.argumentField, chartConfiguration.series[].valueField | |||
| Point to the nested array before binding fields. | Bind to parent objects and get an empty chart. | chartConfiguration.dataPathExpression | |||
| Render only when data is ready. | Display an empty frame that looks broken. | displayConditions | |||
| Use mock data for demos/dev; disable it for production. | Ship with mock data enabled. | useMockData | Parameterize requests to fetch only needed data. | Pull entire datasets without constraints. | getEntityCollectionHttpRequestParametersMap, dataSourceId |
| Expose stable test selectors. | Select elements by volatile text. | dataTestId, id | |||
| Clean up on unmount. | Leave intervals/listeners running. | events.ON_DESTROY |
...