syncfusion-maui-toolkit-circular-progressbar

name	syncfusion-maui-toolkit-circular-progressbar
description	Implements and customize Syncfusion .NET MAUI Circular ProgressBar (SfCircularProgressBar) components. Use when working with circular progress bars, circular progress indicators, radial progress, progress circles, or arc progress in .NET MAUI applications. Covers determinate/indeterminate progress states, animated progress indicators, segmented circular progress, and custom angles.
metadata	{"author":"Syncfusion Inc","version":"1.0.0"}

Implementing Circular ProgressBars in .NET MAUI

The Syncfusion .NET MAUI Circular ProgressBar (SfCircularProgressBar) displays progress in a circular shape with rich customization options. It supports determinate and indeterminate states, smooth animations, segmented progress, gradient colors, custom angles, and center content. Perfect for task completion, loading indicators, dashboards, and progress tracking.

When to Use This Skill

Use this skill when the user needs to:

• Display circular progress indicators for tasks, downloads, uploads, or operations
• Implement determinate progress with known completion percentages (0-100%)
• Show indeterminate progress when duration is unknown (loading, processing)
• Create segmented progress for multi-step workflows or sequential tasks
• Customize appearance with angles, colors, gradients, thickness, or corner styles
• Add animations with easing effects for smooth progress transitions
• Display custom content at the center (text, icons, buttons, images)
• Handle progress events to respond to value changes or completion
• Build semi-circle or arc progress indicators with custom angles
• Visualize progress ranges with multiple colors for different states

Component Overview

The SfCircularProgressBar control provides:

• Flexible States: Determinate (known progress) and indeterminate (unknown duration)
• Visual Customization: Angles, thickness, colors, gradients, corner styles
• Segmentation: Split progress into multiple segments with configurable gaps
• Animation Support: Smooth transitions with customizable duration and easing
• Range Configuration: Custom min/max values (default 0-100)
• Center Content: Add any MAUI view (text, buttons, images) to the center
• Events: ProgressChanged and ProgressCompleted for interaction
• Rich Gradient Support: Multiple color ranges with solid or gradient transitions

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• Installation and NuGet package setup
• Register Syncfusion handler in MauiProgram.cs
• Basic circular progress bar implementation (XAML & C#)
• First working example

States and Progress Modes

📄 Read: references/states.md

• Determinate state (default, for known progress)
• Indeterminate state (for unknown duration)
• When to use each state
• Combining determinate and indeterminate modes

Segments

📄 Read: references/segments.md

• Visualizing multiple sequential tasks
• SegmentCount property for splitting progress
• Gap customization between segments
• Use cases for segmented progress

Appearance Customization

📄 Read: references/appearance.md

• Angle customization (StartAngle, EndAngle) for semi-circles and arcs
• Range colors with GradientStops (solid and gradient)
• Thickness and radius configuration (Pixel vs Factor)
• Corner style customization (flat, curved)
• Progress and track color customization

Animation

📄 Read: references/animation.md

• Animation duration for determinate and indeterminate states
• Easing effects (Linear, CubicInOut, BounceIn, etc.)
• SetProgress() method with custom animation
• Controlling animation speed and behavior

Range Configuration

📄 Read: references/range.md

• Defining custom progress ranges
• Minimum and Maximum properties
• Using factor values (0-1) vs percentages (0-100)

Custom Content

📄 Read: references/custom-content.md

• Adding views to the center (Content property)
• Custom text with data binding
• Buttons for controlling progress
• Images and icons as indicators
• Layout examples

Events

📄 Read: references/events.md

• ProgressChanged event for value changes
• ProgressCompleted event for completion
• Handling event arguments
• Dynamic behavior based on progress