React Donut Chart

    The Ignite UI for React Donut Chart is similar to the Pie Chart, proportionally illustrating the occurrences of a variable. The donut chart can display multiple variables in concentric rings, and provides built-in support for visualizing hierarchical data. The rings are capable of being bound to a different data item, or they can share a common data source.

    React Donut Chart Example

    You can create this type of chart with the IgrDoughnutChart control by binding your data as shown in the example below.

    React Donut Chart Recommendations

    Are React Donut Charts right for your project?

    Donut Charts are appropriate for small data sets and are easy to read at a glance. Donut charts are just one type of part-to-whole visualization. Others include:

    The React Donut Chart includes interactive features that give the viewer tools to analyze data, like:

    • Legends
    • Slice Explosion
    • Slice Selection
    • Chart Animations

    Best Practices for Donut Charts

    • Using multiple data sets to display your data in a ring display.
    • Placing the information such as values or labels, within the hole of the donut for quick explanation of data.
    • Comparing slices or segments as percentage values in proportion to a total value or whole.
    • Showing how a group of categories is broken into smaller segments.
    • Ensuring data segments add up to 100%.
    • Ensuring the color palette is distinguishable for segments/slices of the parts.

    When not to use a Donut Chart

    • Comparing change over time —use a Bar, Line or Area chart.
    • Requiring precise data comparison —use a Bar, Line or Area chart.
    • You have more than 6 or 8 segments (high data volume) — consider a Bar, Line or Area chart if it works for your data story.
    • It would be easier for the viewer to perceive the value difference in a Bar chart.
    • You have negative data, as this can not be represented in a donut chart.

    React Donut Chart - Slice Selection

    The React Donut Chart has the ability to select slices on click. Optionally, you may apply a single custom visual style to the selected slices. The SliceClick event is raised when the user clicks on a slice. Enabling slice selection allows you to modify the slice's selection upon click. The following sample demonstrates how to enable slice selection and set the selected slice color to gray.

    React Donut Chart - Multiple Rings

    It is possible to have a multiple ring display in the React Donut Chart, with each of the rings capable of being bound to a different data item, or they can share a common data source. This can be helpful if you need to display your data as tiers that have an underlying common category, such as the season to month data display below:

    Additional Resources

    You can find more information about related chart types in these topics:

    API Members

    The following table lists API members mentioned in the above sections:

    Chart Type Control Name API Members
    Donut Chart IgrDoughnutChart DoughnutChart