Implementing Busy Indicators

The Syncfusion .NET MAUI Busy Indicator (SfBusyIndicator) provides visual feedback during app loading, data processing, and other time-consuming operations. It offers 7 built-in animation types, extensive customization options, and a simple API for controlling loading states.

When to Use This Skill

Use this skill when you need to:

• Display loading states during data fetching, API calls, or initialization
• Show processing feedback for long-running operations
• Implement activity indicators with custom animations and styling
• Add busy overlays to prevent user interaction during processing
• Create branded loading experiences with custom colors, sizes, and titles
• Control animation states dynamically based on application logic
• Provide visual feedback that improves perceived performance

Common scenarios: Login screens, data synchronization, file uploads, search operations, report generation, async operations, and any task requiring user patience.

Component Overview

Key Capabilities:

• 7 Animation Types: CircularMaterial, LinearMaterial, Cupertino, SingleCircle, DoubleCircle, Globe, HorizontalPulsingBox
• Full Customization: Colors, sizes, speeds, overlay backgrounds
• Title Support: Configurable text with font customization and placement options
• State Control: Start/stop animations programmatically with IsRunning property
• Responsive Design: Auto-scaling fonts and adaptive sizing
• Overlay Support: Optional background overlays with gradient support

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

When to read: First-time implementation, project setup, package installation

What you'll learn:

• Installing Syncfusion.Maui.Core NuGet package
• Registering handlers in MauiProgram.cs
• Creating your first busy indicator
• Basic XAML and C# implementation

Animation Types

📄 Read: references/animation-types.md

When to read: Choosing visual style, implementing specific animation types

What you'll learn:

• All 7 built-in animation types with examples
• CircularMaterial (Android Material Design style)
• LinearMaterial (horizontal progress bar style)
• Cupertino (iOS-style spinner)
• SingleCircle, DoubleCircle (concentric circle animations)
• Globe (3D globe rotation effect)
• HorizontalPulsingBox (pulsing box animation)
• Visual comparisons and use cases

Customization

📄 Read: references/customization.md

When to read: Styling indicators, adjusting colors/sizes, setting animation speed

What you'll learn:

• Indicator color customization (IndicatorColor)
• Overlay background styling (OverlayFill)
• Gradient backgrounds with Brush types
• Animation duration control (DurationFactor: 0-1)
• Indicator sizing (SizeFactor: 0-1)
• Complete styling examples

Title Configuration

📄 Read: references/title-configuration.md

When to read: Adding text labels, customizing fonts, positioning titles

What you'll learn:

• Setting title text (Title property)
• Text color customization (TextColor)
• Title placement (Top, Bottom, None)
• Spacing control (TitleSpacing)
• Font customization (size, attributes, family)
• Auto-scaling support

Controlling Animation State

📄 Read: references/controlling-state.md

When to read: Starting/stopping animations, managing visibility, dynamic control

What you'll learn:

• IsRunning property usage
• Starting and stopping animations
• Default behavior (false)
• Binding to ViewModel properties
• Event-driven state management