syncfusion-react-3d-circular-chart

Implements the Syncfusion React 3D Circular Chart component for pie and donut chart visualization. Use this when users need 3D circular charts, data labels, legends, tooltips, or empty point handling. Guides through installation, configuration, customization, and troubleshooting of 3D Circular Chart

By syncfusion · 554 installs

npx skills add syncfusion/react-ui-components-skills --skill syncfusion-react-3d-circular-chart

Source repository · Upstream listing

Implementing Syncfusion React 3D Circular Charts A comprehensive skill for implementing Syncfusion's React 3D Circular Chart component. This skill guides you through creating pie and donut charts with 3D visualization, data labels, legends, tooltips, and advanced customization options. When to Use This Skill Use this skill when you need to: Create 3D pie or donut charts in React applications Visualize proportional data with circular charts Display data with 3D depth and visual appeal Add interactive tooltips and legends to charts Customize chart appearance with data labels Handle empty or null data points gracefully Export charts to various formats (PNG, JPEG, SVG, PDF) Print charts directly from the browser Implement responsive circular chart visualizations Component Overview The 3D Circular Chart component provides: Pie and Donut Charts: Classic circular visualizations with 3D depth Flexible Data Binding: Easy mapping of data sources to chart series Interactive Features: Tooltips, legends, and click events Visual Customization: Data labels, colors, and radius configurations Export Options: Print and export to multiple formats Empty Point Handling: Smart handling of null/undefined values Responsive Design: Adapts to container size automatically Documentation and Navigation Guide Getting Started 📄 Read: [references/getting started.md](references/getting started.md) Installation and package dependencies Setting up React application with Vite or Create React App Adding 3D Circular Chart component to your project Importing CSS themes Basic pie series implementation with data source Mapping data fields with xName and yName properties Running your first 3D Circular Chart Minimal working example Pie and Donut Charts 📄 Read: [references/pie donut charts.md](references/pie donut charts.md) Injecting PieSeries3D module Rendering default pie charts Customizing chart radius (default 80% of container) Creating various radius pie charts with per slice customization Implementing donut charts using innerRadius property Text and fill color mapping from data source Customizing individual points with pointRender event Complete examples for pie and donut variations Data Labels 📄 Read: [references/data labels.md](references/data labels.md) Enabling data label visibility Injecting CircularChartDataLabel3D module Smart label arrangement to prevent overlap Positioning labels inside or outside the chart Creating custom templates with placeholders Formatting text and styling labels Configuring connector lines Font customization for data labels Legend 📄 Read: [references/legend.md](references/legend.md) Enabling legend visibility Injecting CircularChartLegend3D module Positioning legends (left, right, top, bottom) Alignment options (center, far, near) Reversing legend item order Legend pagination for many items Shape and marker customization Styling and click behavior configuration Tooltip 📄 Read: [references/tooltip.md](references/tooltip.md) Enabling tooltip on hover Injecting CircularChartTooltip3D module Setting custom tooltip headers Format string customization with placeholders Creating tooltip templates Displaying series names and point values Styling tooltip appearance Event based tooltip customization Empty Points 📄 Read: [references/empty points.md](references/empty points.md) Understanding empty points (null/undefined values) Configuring emptyPointSettings property Mode options: Gap, Average, Drop, Zero Gap mode: skipping empty data points Average mode: using calculated averages Drop mode: excluding from chart Zero mode: treating as zero values Custom fill colors for empty points Title and Subtitle 📄 Read: [references/title and subtitle.md](references/title and subtitle.md) Adding chart titles with title property Title positioning and alignment Customizing title style (font, color, size) Adding subtitles with subTitle property Subtitle positioning Styling subtitles independently Combining title and subtitle Responsive title sizing Print and Export 📄 Read: [references/print and export.md](references/print and export.md) Printing charts directly from browser Using print method with chart ID Exporting to image formats (JPEG, PNG, SVG) Exporting to PDF with pdfExport method Specifying export type and filename Button triggered print and export Export quality and resolution settings Troubleshooting export issues API Reference 📄 Read: [references/api reference.md](references/api reference.md) Summary of component properties, methods, and events based on the official Syncfusion API docs for CircularChart3DComponent . Quick Start Example Common Patterns Creating a Donut Chart Adding Data Labels Enabling Legend and Tooltip Handling Empty Points Key Props Reference CircularChart3DComponent Props title : Chart title text subTitle : Chart subtitle text legendSettings : Configure legend appearance and behavior tooltip : Enable and customize tooltips enableExport : Enable export functionality width/height : Chart dimensions CircularChart3DSeriesDirective Props dataSource : Array of data objects xName : Property name for category/label yName : Property name for values radius : Chart radius (percentage string, e.g., "70%") innerRadius : Inner radius for donut charts (percentage) dataLabel : Configuration for data labels emptyPointSettings : Handling null/undefined values pointColorMapping : Map colors from data source Module Injection Required modules must be injected via <Inject services={[...]} / : PieSeries3D : Core pie/donut chart functionality CircularChartDataLabel3D : Data label features CircularChartLegend3D : Legend functionality CircularChartTooltip3D : Tooltip features CircularChart3DExport : Export to image formats CircularChart3DPdfExport : PDF export capability Common Use Cases Sales Distribution Dashboard Perfect for displaying market share, sales by category, or revenue distribution across products/regions. Budget Allocation Visualize budget breakdown by department, expense categories, or cost centers with clear proportional representation. Survey Results Show poll results, customer feedback distribution, or demographic breakdowns with intuitive circular visualization. Portfolio Composition Display investment allocation, asset distribution, or resource allocation with interactive charts. Time Allocation Represent time spent on activities, project phases, or resource utilization with donut charts. Troubleshooting Tips Chart not rendering? Ensure you've installed @syncfusion/ej2 react charts package Import required CSS theme file Verify data source is properly formatted array Check that required modules are injected (PieSeries3D) Data labels overlapping? The component automatically arranges labels to prevent overlap Use position: 'Outside' for better spacing Consider reducing font size or using templates Export not working? Inject CircularChart3DExport or CircularChart3DPdfExport modules Set enableExport: true on the chart component Ensure you're calling the correct method (export or pdfExport) Colors not displaying correctly? Use pointColorMapping to map colors from data source Specify colors in data objects or use chart palettes Check CSS theme is properly imported Ready to build? Start with [references/getting started.md](references/getting started.md) for installation and basic setup, then explore specific features as needed.