Class RadBusyIndicator

Represents a sophisticated loading indicator control that provides visual feedback to users during long-running operations. The RadBusyIndicator offers a rich collection of built-in animations and extensive customization options to create engaging loading experiences that keep users informed and engaged while content is being processed.

Inheritance

System.Object

RadLayout

RadBusyIndicator

TreeViewItemBusyIndicator

Namespace: Telerik.Maui.Controls

Assembly: Telerik.Maui.Controls.dll

Syntax

public class RadBusyIndicator : RadLayout

Remarks

The RadBusyIndicator is designed to enhance user experience by providing clear visual feedback during asynchronous operations such as data loading, file processing, network requests, or any time-consuming tasks. It automatically manages the display of loading animations and can optionally dim or hide underlying content to focus user attention on the loading state.

Key Features:

Rich Animation Library: 10 built-in animation types ranging from simple spinners to complex geometric patterns
Custom Animation Support: Create your own animations using the flexible RadAnimation system
Content Management: Automatically dim or hide content while busy, with customizable opacity levels
Flexible Content Templates: Use custom templates for busy content including text, images, and complex layouts
Responsive Design: Automatically adapts to different screen sizes and orientations
Theme Integration: Seamlessly integrates with application themes and supports custom styling

Animation Customization:

Size Control: Customize animation dimensions with AnimationContentWidthRequest and AnimationContentHeightRequest
Color Theming: Apply custom colors to match your application's brand and design
Performance Optimized: Hardware-accelerated animations for smooth performance across all platforms

Perfect for scenarios including data loading screens, form submission feedback, file upload/download progress, authentication processes, and any situation where users need clear indication that the application is actively working on their request. The control automatically handles platform-specific rendering optimizations to ensure consistent performance across iOS, Android, Windows, and macOS.

Examples

Basic usage with default animation:

<telerik:RadBusyIndicator IsBusy="{Binding IsLoading}"
                          AnimationType="Animation1" />

Custom styling with busy content:

<telerik:RadBusyIndicator IsBusy="{Binding IsProcessing}"
                          AnimationType="Animation5"
                          AnimationContentColor="#FF6B35"
                          ContentUnderOpacity="0.3">
    <telerik:RadBusyIndicator.BusyContent>
        <StackLayout>
            <Label Text="Processing your request..." HorizontalOptions="Center" />
            <Label Text="Please wait..." FontSize="12" TextColor="Gray" HorizontalOptions="Center" />
        </StackLayout>
    </telerik:RadBusyIndicator.BusyContent>
    <telerik:RadBusyIndicator.Content>
        <!-- Your main content here -->
    </telerik:RadBusyIndicator.Content>
</telerik:RadBusyIndicator>

Custom animation with multiple RadAnimation objects:

<telerik:RadBusyIndicator IsBusy="True" AnimationType="Custom">
    <telerik:RadBusyIndicator.Animations>
        <telerik:RadScaleAnimation TargetScale="1.2" Duration="1000" />
        <telerik:RadRotationAnimation Angle="360" Duration="2000" />
    </telerik:RadBusyIndicator.Animations>
</telerik:RadBusyIndicator>

Constructors

RadBusyIndicator()

Initializes a new instance of the RadBusyIndicator class with default settings. Creates a ready-to-use busy indicator with platform-optimized default animation and styling.

Declaration

public RadBusyIndicator()

Fields

AnimationContentColorProperty

Identifies the AnimationContentColor bindable property.