Swimlane’s @swimlane/ngx-charts lets Angular applications present data as SVG-based charts, with D3 providing chart math such as scales, axes, and shape generators. Before installing it or copying an example, check that the library release supports your Angular version: compatibility changes across major releases, and the project’s changelog distinguishes stable releases from prereleases.
What ngx-charts does
Swimlane ngx-charts is a declarative charting framework for Angular. In the project README’s description, Angular renders and animates the SVG elements, while D3 supplies math functions, scales, axes, and shape generators. In practical terms, charts are part of the Angular view rather than a separate chart renderer embedded in it.
The README documents bar, line, area, pie, donut, bubble, gauge, heatmap, treemap, number-card, and Sankey charts. It also lists standard, grouped, stacked, and normalized bar variants. The features documentation additionally names vertical box charts and bubble/scatter charts; it marks force-directed graphs as deprecated and points users to ngx-graph for that use case. These are documented capabilities, not a guarantee that every option works identically in every release.
Check Angular compatibility before installing
Do not choose a package version from an old tutorial without checking the project’s current README, release information, and compatibility notes. The changelog records that ngx-charts 23.0.0 added Angular 20 support and removed support for Angular 17 and earlier. It also lists 24.0.0-alpha.0 as adding Angular 21 support and removing Angular 18 support. The latter is explicitly an alpha release, not evidence that a stable Angular 21-compatible release is available.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstall#1 Best Overall
- Wiley
- Language: english
- Book - storytelling with data: a data visualization guide for business professionals
The README’s documented installation command is npm i @swimlane/ngx-charts --save. Treat it as the project’s general command, not a version pin or a complete setup recipe: confirm that the package version you install supports your Angular version, then follow that release’s README for dependencies, component or module imports, and configuration. This matters especially when using standalone components, because the available evidence does not establish a single setup path that applies to all versions.
Choose a chart for the comparison you need
The project documents a broad range of chart types but does not prescribe which one to use for a particular data shape. Use the comparison you want readers to make as your starting point; the following is practical guidance, not an official ngx-charts decision tree.
| What you need to show | Chart families to consider | Check before choosing |
|---|---|---|
| Compare values across categories | Horizontal or vertical bars; grouped, stacked, or normalized bars | Use grouped bars when readers need to compare series directly. Stacked bars show totals and contributions; normalized bars emphasize proportions rather than absolute totals. |
| Show change across an ordered range, often time | Line or area | Consider whether connecting values clarifies a trend and whether filled areas could obscure overlapping series. |
| Show parts of a whole | Pie or donut | These work best when the number of categories and the differences between their shares remain easy to read. |
| Show magnitude through circles or a distribution | Bubble, bubble/scatter, or vertical box chart | Make the meaning of position, size, and any distribution marks clear in labels or supporting text. |
| Show a single indicator, intensity, hierarchy, or flow | Gauge, number card, heatmap, treemap, or Sankey | Match the chart to the relationship: an indicator, grid of values, nested hierarchy, or movement between stages. |
ngx-charts also documents autoscaling, timeline filtering, line interpolation, configurable axis labels, legends, label positioning, real-time data support, advanced tooltips, and data-point event handlers. Confirm the exact API and behavior against the documentation and examples for the release in your application before relying on any of them.
Build from a version-matched example
Once you have selected a compatible release and a chart, start from an example in that release’s official README or example application. The available project information establishes the installation command and chart families, but not a current, complete input-data schema or a setup recipe that can safely be presented as universal. Copying a component import or data object from another major version can therefore produce a misleading tutorial result.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →- Verify the package and Angular versions. Compare your app’s Angular version with the package release notes and compatibility information; distinguish stable releases from alpha or other prereleases.
- Install the compatible package. Use the documented npm command or the release-specific instructions, and keep the selected version consistent with your project’s dependency setup.
- Follow that release’s setup example. Use its documented imports, configuration, and input data shape rather than assuming module-based or standalone setup.
- Adapt the example’s data and labels. Preserve the expected structure, then replace sample values and category names with your application’s data.
- Add only verified options. Configure axes, legends, labels, tooltips, scaling, or interactions using the API documented for the chosen version.
- Run the chart in your application. Check that values, labels, and interactions remain understandable with your real data and at the sizes your interface supports.
Check responsiveness and accessibility in your app
The project’s features documentation advertises responsive layout and animation controls, but that does not establish accessibility conformance or prove that a particular chart will fit every layout. Test the rendered chart in context rather than assuming responsiveness solves every presentation problem.
Quick Recap
Best Value
- Resize the containing view and check that axes, labels, legends, and tooltips remain visible and legible.
- Check dense or long category labels at narrow widths, and make sure the chart does not conceal values readers need to compare.
- Verify that interaction-dependent information is available in the ways your users need; do not assume a tooltip alone is sufficient.
- Test keyboard and assistive-technology access in your actual application, and provide an accessible text or tabular alternative when the visual chart does not communicate the data adequately.
- Confirm that animation and real-time updates do not make changes difficult to follow or interfere with your interface’s accessibility needs.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
