feat: TemplatedTaskLoader Events

Author: Jean-Marie Alfonsi

Retronado.Maui/Views/CommandsPage.xaml

@@ -31,7 +31,8 @@
                          IsRefreshing="{Binding Loader.ShowRefresher}"
                          RefreshColor="{StaticResource AccentColor}">
                 <ScrollView Grid.Row="1">
-                    <tlv:TemplatedTaskLoader TaskLoaderNotifier="{Binding Loader}">
+                    <tlv:TemplatedTaskLoader x:Name="TaskLoader"
+                                             TaskLoaderNotifier="{Binding Loader}">
                         <tlv:TemplatedTaskLoader.ResultControlTemplate>
                             <ControlTemplate>
                                 <Grid x:DataType="viewModels:CommandsPageViewModel"

Retronado.Maui/Views/CommandsPage.xaml.cs

@@ -1,5 +1,6 @@
-using Microsoft.Maui.Controls.PlatformConfiguration;
+using Microsoft.Maui.Controls.PlatformConfiguration;
 using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;
+using Sharpnado.TaskLoaderView;
 
 namespace Sample.Views;
 
@@ -10,6 +11,12 @@ public CommandsPage()
         InitializeComponent();
 
         ResourcesHelper.SetSublimeGameMode();
+
+        // Subscribe to TemplatedTaskLoader events
+        TaskLoader.LoadingControlTemplateLoaded += OnLoadingControlTemplateLoaded;
+        TaskLoader.ResultControlTemplateLoaded += OnResultControlTemplateLoaded;
+        TaskLoader.ErrorControlTemplateLoaded += OnErrorControlTemplateLoaded;
+        TaskLoader.EmptyControlTemplateLoaded += OnEmptyControlTemplateLoaded;
     }
 
     protected override void OnAppearing()
@@ -20,4 +27,24 @@ protected override void OnAppearing()
         safeInsets.Bottom = 0;
         Padding = safeInsets;
     }
-}
+
+    private void OnLoadingControlTemplateLoaded(object? sender, EventArgs e)
+    {
+        System.Diagnostics.Debug.WriteLine("[CommandsPage] Loading template loaded");
+    }
+
+    private void OnResultControlTemplateLoaded(object? sender, EventArgs e)
+    {
+        System.Diagnostics.Debug.WriteLine("[CommandsPage] Result template loaded");
+    }
+
+    private void OnErrorControlTemplateLoaded(object? sender, EventArgs e)
+    {
+        System.Diagnostics.Debug.WriteLine("[CommandsPage] Error template loaded");
+    }
+
+    private void OnEmptyControlTemplateLoaded(object? sender, EventArgs e)
+    {
+        System.Diagnostics.Debug.WriteLine("[CommandsPage] Empty template loaded");
+    }
+}

Sharpnado.Maui.TaskLoaderView/Sharpnado.Maui.TaskLoaderView.csproj

@@ -10,9 +10,9 @@
     <RootNamespace>Sharpnado.TaskLoaderView</RootNamespace>
 
     <Product>$(AssemblyName) ($(TargetFramework))</Product>
-    <AssemblyVersion>2.6.1.0</AssemblyVersion>
-    <AssemblyFileVersion>2.6.1.0</AssemblyFileVersion>
-    <Version>2.6.1.0</Version>
+    <AssemblyVersion>2.6.2.0</AssemblyVersion>
+    <AssemblyFileVersion>2.6.2.0</AssemblyFileVersion>
+    <Version>2.6.2.0</Version>
     <PackOnBuild>true</PackOnBuild>
     <NeutralLanguage>en</NeutralLanguage>
     <UseFullSemVerForNuGet>false</UseFullSemVerForNuGet>
@@ -22,7 +22,7 @@
     <RepositoryUrl>https://github.com/roubachof/Sharpnado.TaskLoaderView</RepositoryUrl>
     <PackageIcon>maui_logo.png</PackageIcon>
     <PackageTags>maui, netmaui, xamarin, xamarin.forms, skeleton, loading, states, async, task, loader, isbusy, control, taskloader, taskloadernotifier</PackageTags>
-    <PackageReleaseNotes>Fix the insertion of the loading states view that could cause an index out of range exception.</PackageReleaseNotes>
+    <PackageReleaseNotes>Added events to TemplatedTaskLoader for each control template state (LoadingControlTemplateLoaded, ResultControlTemplateLoaded, ErrorControlTemplateLoaded, EmptyControlTemplateLoaded). These events are raised when the corresponding control template is loaded, allowing you to react to state changes.</PackageReleaseNotes>
     <Title>Maui TaskLoaderView: free yourself from IsBusy=true!</Title>
     <Summary>Free yourself from IsBusy=true! The `TaskLoaderView` is a UI component that handles all your UI loading state (Loading, Error, Result, Notification), and removes all the pain of async loading from your view models (try catch / async void / IsBusy / HasErrors / base view models / ...) thanks to its brother the `TaskLoaderNotifier`.</Summary>
     <Description>Free yourself from IsBusy=true!

Sharpnado.Maui.TaskLoaderView/TemplatedTaskLoader.cs

@@ -4,6 +4,7 @@ namespace Sharpnado.TaskLoaderView;
 
 public class TemplatedTaskLoader : ContentView
 {
+
     public static readonly BindableProperty TaskLoaderNotifierProperty = BindableProperty.Create(
         nameof(TaskLoaderNotifier),
         typeof(ITaskLoaderNotifier),
@@ -30,6 +31,14 @@ public class TemplatedTaskLoader : ContentView
         typeof(ControlTemplate),
         typeof(TemplatedTaskLoader));
 
+    public event EventHandler? ResultControlTemplateLoaded;
+
+    public event EventHandler? LoadingControlTemplateLoaded;
+
+    public event EventHandler? ErrorControlTemplateLoaded;
+
+    public event EventHandler? EmptyControlTemplateLoaded;
+
     public ITaskLoaderNotifier? TaskLoaderNotifier
     {
         get => (ITaskLoaderNotifier?)GetValue(TaskLoaderNotifierProperty);
@@ -90,24 +99,28 @@ private void Initialize()
         if (TaskLoaderNotifier.ShowResult)
         {
             ControlTemplate = ResultControlTemplate;
+            ResultControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
             return;
         }
 
         if (TaskLoaderNotifier.ShowError)
         {
             ControlTemplate = ErrorControlTemplate ?? ResultControlTemplate;
+            ErrorControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
             return;
         }
 
         if (TaskLoaderNotifier.ShowEmptyState)
         {
             ControlTemplate = EmptyControlTemplate ?? ResultControlTemplate;
+            EmptyControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
             return;
         }
 
         if (TaskLoaderNotifier.ShowLoader)
         {
             ControlTemplate = LoadingControlTemplate ?? ResultControlTemplate;
+            LoadingControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
         }
     }
 
@@ -117,19 +130,23 @@ private void NotifierPropertyChanged(object sender, PropertyChangedEventArgs e)
         {
             case nameof(ITaskLoaderNotifier.ShowResult) when TaskLoaderNotifier!.ShowResult:
                 ControlTemplate = ResultControlTemplate;
+                ResultControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
                 break;
 
             case nameof(ITaskLoaderNotifier.ShowError) when TaskLoaderNotifier!.ShowError:
                 ControlTemplate = ErrorControlTemplate;
+                ErrorControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
                 break;
 
             case nameof(ITaskLoaderNotifier.ShowLoader) when TaskLoaderNotifier!.ShowLoader:
                 ControlTemplate = LoadingControlTemplate;
+                LoadingControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
                 break;
 
             case nameof(ITaskLoaderNotifier.ShowEmptyState) when TaskLoaderNotifier!.ShowEmptyState:
                 ControlTemplate = EmptyControlTemplate;
+                EmptyControlTemplateLoaded?.Invoke(this, EventArgs.Empty);
                 break;
         }
     }
-}
+}