Implementing .NET MAUI Circular Charts

This skill guides you through implementing Syncfusion® .NET MAUI Circular Charts (SfCircularChart), which provides pie, doughnut, and radial bar chart visualizations for displaying part-to-whole relationships and data distributions.

When to Use This Skill

Use this skill when you need to:

• Display proportional data - Show how parts contribute to a whole (market share, budget allocation, survey results)
• Create pie charts - Standard circular charts divided into slices
• Implement doughnut charts - Circular charts with a center hole, optionally displaying additional information
• Build radial bar charts - Compare values across categories with circular progress indicators
• Show data distributions - Visualize percentage breakdowns or category comparisons
• Enable chart interactions - Add tooltips, explode effects, selection, and legends
• Group small values - Automatically combine small data segments into an "Others" category
• Export visualizations - Save charts as images or PDFs
• Customize appearance - Style colors, strokes, spacing, and visual effects

Component Overview

SfCircularChart is the .NET MAUI control for circular data visualization with these capabilities:

• Three chart types: PieSeries, DoughnutSeries, RadialBarSeries
• Data binding: Bind to collections with XBindingPath and YBindingPath
• Interactive features: Tooltips, explode, selection, legends
• Customization: Colors, strokes, spacing, angles, radius control
• Data labels: Show values/percentages on segments
• Grouping: Combine small values into "Others" category
• Center content: Display custom views in doughnut/radial bar centers
• Export: Save as PNG, JPEG, or PDF

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• NuGet package installation (Syncfusion.Maui.Charts)
• Basic SfCircularChart setup and initialization
• Creating data models and view models
• Binding data to chart series
• Adding title, legend, and data labels
• Complete minimal working example

Chart Types

📄 Read: references/chart-types.md

• PieSeries - Standard pie chart implementation
• DoughnutSeries - Doughnut chart with inner radius and center view
• RadialBarSeries - Circular progress/comparison bars
• Radius property for sizing charts
• StartAngle and EndAngle for semi-circular charts
• InnerRadius configuration for doughnut and radial bar
• CenterView and CenterHoleSize for center content
• Code examples for all chart types

Data Labels

📄 Read: references/data-labels.md

• Enabling and configuring data labels
• Label positioning and alignment
• Custom label templates
• Smart label positioning to prevent overlap
• Label connectors for external labels
• Label formatting (values, percentages, custom format)
• Styling and appearance customization

Legend

📄 Read: references/legend.md

• Enabling ChartLegend
• Legend positioning (top, bottom, left, right)
• Legend icon types and customization
• Custom legend templates
• Toggle visibility functionality
• Legend styling and appearance

Appearance and Styling

📄 Read: references/appearance.md

• PaletteBrushes for segment colors
• Stroke and StrokeWidth for borders
• Opacity settings for transparency
• GapRatio for segment spacing (radial bar)
• MaximumValue for radial bar range
• CapStyle customization (flat, curved ends)
• Track customization for radial bar (TrackFill, TrackStroke)
• Custom brushes and gradient fills

Tooltip

📄 Read: references/tooltip.md

• Enabling tooltips with EnableTooltip
• Default tooltip behavior
• Custom tooltip templates
• Tooltip content customization
• Styling tooltip appearance
• Interactive hover behavior

Explode Feature

📄 Read: references/explode.md

• Exploding chart segments outward
• ExplodeIndex to specify which segments explode
• ExplodeRadius for explosion distance
• ExplodeOnTouch for user interaction
• Exploding multiple segments
• Visual emphasis and separation

Selection

📄 Read: references/selection.md

• Enabling selection behavior
• SelectionBehavior configuration
• Selection modes (single, multiple)
• Handling selected index
• Visual feedback for selection
• Multi-segment selection

Data Grouping

📄 Read: references/groupto.md

• GroupTo property for automatic grouping
• Combining small values into "Others" category
• Setting grouping threshold
• Custom group labels and appearance
• Improving chart readability with many small segments

Accessibility

📄 Read: references/accessibility.md

• Screen reader announcements for titles, segments, and legend items
• Enabling accessibility per platform (TalkBack, VoiceOver, Narrator)
• Keyboard navigation (Windows Narrator, macOS VoiceOver)
• Gesture navigation (Android TalkBack, iOS VoiceOver)
• Series compatibility (RadialBarSeries not supported)
• Providing meaningful labels for informative announcements

Exporting Charts

📄 Read: references/exporting.md

• Exporting as PNG or JPEG images
• Exporting as PDF documents
• Using SaveAsImage and GetStreamAsync methods
• Stream-based export
• Export quality and resolution settings
• Code examples for each export format