This demo demonstrates how create a React Donut Chart with our powerful JavaScript library, SciChart.js.
drawExample.ts
index.tsx
theme.ts
1import { appTheme } from "../../../theme";
2import {
3 EPieType,
4 ESizingMode,
5 SciChartPieSurface,
6 PieSegment,
7 GradientParams,
8 Point,
9 ELegendOrientation,
10 ELegendPlacement,
11} from "scichart";
12
13export const drawExample = async (rootElement: string | HTMLDivElement) => {
14 // Create the pie chart
15 const sciChartPieSurface = await SciChartPieSurface.create(rootElement, {
16 theme: appTheme.SciChartJsTheme,
17 pieType: EPieType.Donut,
18 holeRadius: 0.6,
19 holeRadiusSizingMode: ESizingMode.Relative,
20 animate: true,
21 seriesSpacing: 10,
22 showLegend: true,
23 showLegendSeriesMarkers: true,
24 animateLegend: true,
25 });
26 // Optional placement of legend
27 sciChartPieSurface.legend.orientation = ELegendOrientation.Vertical;
28 sciChartPieSurface.legend.placement = ELegendPlacement.TopLeft;
29
30 // SciChart.js expects a list of PieSegment, however data is often formatted like this
31 // Dataset = 'percentage market share of phones, 2022'
32 const dataset = [
33 { name: "Chrome", percent: 65.27 },
34 { name: "Safari", percent: 19.03 },
35 { name: "Edge", percent: 4.4 },
36 { name: "Firefox", percent: 3.07 },
37 { name: "Samsung", percent: 2.7 },
38 { name: "Opera", percent: 2.49 },
39 { name: "Android", percent: 0.78 },
40 { name: "IE", percent: 0.32 },
41 ];
42
43 // Colors are just hex strings, supporting #FFFFFF (RBG) or 8-digit with RGBA or CSS color strings e.g. rgba()
44 const colors = [
45 { color1: appTheme.VividOrange, color2: appTheme.MutedOrange },
46 { color1: appTheme.Indigo, color2: appTheme.VividBlue },
47 { color1: appTheme.MutedSkyBlue, color2: appTheme.MutedTeal },
48 { color1: appTheme.MutedTeal, color2: appTheme.PaleTeal },
49 { color1: appTheme.VividSkyBlue, color2: appTheme.MutedSkyBlue },
50 { color1: appTheme.MutedRed },
51 { color1: appTheme.MutedPink },
52 { color1: appTheme.VividPink },
53 ];
54
55 // Optional Relative radius adjustment per segment
56 const radiusSize = [0.8, 0.85, 0.9, 0.9, 0.9, 0.95, 0.95, 0.95];
57
58 const toPieSegment = (name: string, value: number, radiusAdjustment: number, color1: string, color2: string) => {
59 return new PieSegment({
60 value,
61 text: name,
62 labelStyle: { color: appTheme.ForegroundColor },
63 radiusAdjustment,
64 showLabel: value > 2,
65 colorLinearGradient: new GradientParams(new Point(0, 0), new Point(0, 1), [
66 { color: color1, offset: 0 },
67 { color: color2 || color1 + "77", offset: 1 },
68 ]),
69 });
70 };
71
72 // Transform the data to pie segment and add to scichart
73 const pieSegments = dataset.map((row, index) =>
74 toPieSegment(row.name, row.percent, radiusSize[index], colors[index].color1, colors[index].color2)
75 );
76
77 sciChartPieSurface.pieSegments.add(...pieSegments);
78
79 return { sciChartSurface: sciChartPieSurface };
80};
81This example demonstrates how to implement a React Donut Chart using the SciChart.js library. The primary goal of the example is to visualize data as a donut chart with animated segments, legends, and gradient color configurations. It showcases how to integrate SciChart.js in a React application using the <SciChartReact/> component from the scichart-react package.
The example initializes the chart asynchronously in a React functional component. The main chart creation happens in the drawExample function, where a SciChartPieSurface instance is created and configured to render a donut chart. Key configurations include setting the pieType property to EPieType.Donut, defining the holeRadius, enabling animations, and customizing the legend placement. The configuration of linear gradient fills for each pie segment demonstrates how to create visually appealing charts. For detailed guidelines on setting up SciChart with React, refer to the React Charts with SciChart.js documentation.
The implementation leverages advanced features such as animated updates, dynamic gradient configurations for each pieSegment, and the inclusion of a legend with series markers that animate into place. Each segment of the donut chart is generated dynamically from a dataset, with custom color gradients defined by specifying start and end colors. Detailed information on the donut chart type and its configurations is available in the Donut Chart Documentation.
The React integration is achieved through the <SciChartReact/> component, which simplifies rendering and updating the chart within the React component lifecycle. The asynchronous initialization pattern used in the drawExample function ensures that the chart is created efficiently and can be cleaned up when the component unmounts. Developers are encouraged to apply best practices for styling by using CSS modules and inline styles, as demonstrated in the index.tsx file. For additional best practices on React component lifecycle management and cleanup, the Creating a SciChart React Component from the Ground Up resource is highly recommended.

Discover how to create a high performance React Line Chart with SciChart - the leading JavaScript library. Get your free demo now.

Discover how to create a React Spline Line Chart with SciChart. Demo includes algorithm for smoother lines. Get your free trial now.

Discover how to create a React Digital Line Chart with SciChart - your feature-rich JavaScript Chart Library. Get your free demo now.

Easily create a React Band Chart or High-Low Fill with SciChart - high performance JavaScript Chart Library. Get your free trial now.

SciChart's React Spline Band Chart makes it easy to draw thresholds or fills between two lines on a chart. Get your free demo today.

Learn how to create a React Digital Band Chart or High-Low Fill Chart with SciChart's easy-to-follow demos. Get your free trial today.

Create a high performance React Bubble Chart with Sci-Chart. Demo shows how to draw point-markers at X,Y locations. Get your free demo now.

Discover how to create a React Candlestick Chart or Stock Chart using SciChart.js. For high Performance JavaScript Charts, get your free demo now.

React Column Chart demo by SciChart supports gradient fill and paletteproviders for more custom coloring options. Get your free demo now.

Population Pyramid of Europe and Africa

Create React Error Bars Chart using high performance SciChart.js. Display uncertainty or statistical confidence of a data-point. Get free demo now.

Easily create React Impulse Chart or Stem Chart using SciChart.js - our own high performance JavaScript Chart Library. Get your free trial now.

Create React Text Chart with high performance SciChart.js.

Discover how to create React Fan Chart with SciChart. Zoom in to see the detail you can go to using our JavaScript Charts. Get your free demo today.

Easily create a high performance React Heatmap Chart with SciChart. Get your free trial of our 5-star rated JavaScript Chart Component today.

Create React Non Uniform Chart using high performance SciChart.js. Display Heatmap with variable cell sizes. Get free demo now.

Design a highly dynamic React Heatmap Chart With Contours with SciChart's feature-rich JavaScript Chart Library. Get your free demo today.

Design a highly dynamic React Map Chart with Heatmap overlay with SciChart's feature-rich JavaScript Chart Library. Get your free demo today.

Create React Mountain Chart with SciChart.js. Zero line can be zero or a specific value. Fill color can be solid or gradient as well. Get a free demo now.

React Spline Mountain Chart design made easy. Use SciChart.js' JavaScript Charts for high performance, feature-rich designs. Get free demo now.

Create React Digital Mountain Chart with a stepped-line visual effect. Get your free trial of SciChart's 5-star rated JavaScript Chart Component now.

React Realtime Mountain Chart made easy. Add animated, real-time updates with SciChart.js - high performance JavaScript Charts. Get free trial now.

Create React Scatter Chart with high performance SciChart.js. Easily render pre-defined point types. Supports custom shapes. Get your free trial now.

Discover how to create a React Stacked Column Chart using our feature-rich JavaScript Chart Library, SciChart.js. Get your free demo today!

Design React Stacked Group Column Chart side-by-side using our 5-star rated JavaScript Chart Framework, SciChart.js. Get your free demo now.

Design a high performance React Stacked Mountain Chart with SciChart.js - your one-stop JavaScript chart library. Get free demo now to get started.

Design a high performance React Stacked Mountain Chart with SciChart.js - your one-stop JavaScript chart library. Get free demo now to get started.

Easily create and customise a high performance React Pie Chart with 5-star rated SciChart.js. Get your free trial now to access the whole library.

View the React Linear Gauge Chart example to combine rectangles & annotations. Create a linear gauge dashboard with animated indicators and custom scales.

Demonstrates how to color areas of the chart surface using background Annotations using SciChart.js Annotations API

Create a React Histogram Chart with custom texture fills and patterns. Try the SciChartReact wrapper component for seamless React integration today.

Build a React Gantt Chart with SciChart. View the demo for horizontal bars, rounded corners and data labels to show project timelines and task completion.

Create a React Choropleth map, a type of thematic map where areas are shaded or patterned in proportion to the value of a variable being represented.

Create a React Multi-Layer Map Example, using FastTriangleRenderableSeries with GeoJSON data-points using a constrained delaunay triangulation algorithm.

View the React Vector Field Plot example from SciChart, including dynamic vector generation, gradient-colored segments, and interactive zoom/pan. Try demo.

Build a React Waterfall Chart with dynamic coloring, multi-line data labels and responsive design, using the SciChartReact component for seamless integration.

Try the React Box Plot Chart example for React-friendly chart lifecycle management, dynamic sub-surface positioning, and custom styling. Try the demo now.

Create React Triangle Meshes with the Triangle Series from SciChart. This demo supports strip mode, list mode and the drawing of polygons. View the example.

Create a React Treemap Chart to define rectangle positions based on total value. Use SciChart FastRectangleRenderableSeries and d3-hierarchy.js layouts.