Blazor.FlexLoader 1.3.2

Blazor.FlexLoader

<div align="center"> <img src="./assets/icon-github.svg" alt="Blazor.FlexLoader" width="128" height="128" /> <h3>?? Un composant Blazor flexible pour les indicateurs de chargement</h3> </div>

???? Fran�ais | ???? English

Fran�ais

Un composant Blazor flexible et r�utilisable pour afficher des indicateurs de chargement avec support pour des images personnalis�es, du texte et du contenu custom.

?? Fonctionnalit�s

• ? Indicateur de chargement global pour les applications Blazor
• ? Support d'images personnalis�es (GIF, SVG, PNG, etc.)
• ? Texte de chargement personnalisable
• ? Contenu custom avec RenderFragment
• ? Positionnement absolu ou fixe
• ? Couleurs et styles personnalisables
• ? Fermeture automatique configurable
• ? Fermeture au clic sur l'overlay
• ? Compatible .NET 9
• ? CI/CD automatis� avec GitHub Actions

?? Installation

dotnet add package Blazor.FlexLoader

??? Configuration

1. Enregistrer le service dans Program.cs

using Blazor.FlexLoader.Extensions;

builder.Services.AddBlazorFlexLoader();

2. Ajouter les imports dans _Imports.razor

@using Blazor.FlexLoader.Components
@using Blazor.FlexLoader.Services

3. Ajouter le composant dans votre layout

<FlexLoader />

?? Utilisation

M�thodes simples Show/Close

@inject LoaderService LoaderService

<button @onclick="ShowLoader">Afficher le loader</button>

@code {
    private async Task ShowLoader()
    {
        LoaderService.Show(); // Afficher le loader
        
        try
        {
            await SomeAsyncOperation();
        }
        finally
        {
            LoaderService.Close(); // Masquer le loader
        }
    }
}

M�thodes Increment/Decrement (gestion avanc�e)

LoaderService.Increment(); // Compter +1
LoaderService.Decrement(); // Compter -1
LoaderService.Reset();     // Forcer fermeture

?? Param�tres du composant

?? API du LoaderService

public class LoaderService
{
    public bool IsLoading { get; }
    
    // M�thodes simples
    public void Show();       // Afficher
    public void Close();      // Masquer
    
    // M�thodes avanc�es
    public void Increment();  // Compter +1
    public void Decrement();  // Compter -1
    public void Reset();      // Forcer fermeture
    
    public event EventHandler? OnChange;
}

?? Licence

MIT

English

A flexible and reusable Blazor component for displaying loading indicators with support for custom images, text, and custom content.

?? Features

• ? Global loading indicator for Blazor applications
• ? Support for custom images (GIF, SVG, PNG, etc.)
• ? Customizable loading text
• ? Custom content with RenderFragment
• ? Absolute or fixed positioning
• ? Customizable colors and styles
• ? Configurable auto-close
• ? Close on overlay click
• ? Compatible with .NET 9
• ? Automated CI/CD with GitHub Actions

?? Installation

dotnet add package Blazor.FlexLoader

??? Setup

1. Register the service in Program.cs

using Blazor.FlexLoader.Extensions;

builder.Services.AddBlazorFlexLoader();

2. Add imports in _Imports.razor

@using Blazor.FlexLoader.Components
@using Blazor.FlexLoader.Services

3. Add the component to your layout

<FlexLoader />

?? Usage

Simple Show/Close methods

@inject LoaderService LoaderService

<button @onclick="ShowLoader">Show loader</button>

@code {
    private async Task ShowLoader()
    {
        LoaderService.Show(); // Show the loader
        
        try
        {
            await SomeAsyncOperation();
        }
        finally
        {
            LoaderService.Close(); // Hide the loader
        }
    }
}

Increment/Decrement methods (advanced management)

LoaderService.Increment(); // Count +1
LoaderService.Decrement(); // Count -1
LoaderService.Reset();     // Force close

?? Component Parameters

?? LoaderService API

public class LoaderService
{
    public bool IsLoading { get; }
    
    // Simple methods
    public void Show();       // Display
    public void Close();      // Hide
    
    // Advanced methods
    public void Increment();  // Count +1
    public void Decrement();  // Count -1
    public void Reset();      // Force close
    
    public event EventHandler? OnChange;
}

?? License

MIT