feat(Console): update OnClear support async (#6325)

* refactor: 代码格式化

* refactor: 更改 Func 类型支持异步

* refactor: 更改为私有属性

* doc: 更新示例

* test: 更新单元测试

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/Consoles.razor.cs

@@ -19,7 +19,11 @@ public sealed partial class Consoles
     /// <summary>
     /// OnClear
     /// </summary>
-    private void OnClear() => Messages.Clear();
+    private Task OnClear()
+    {
+        Messages.Clear();
+        return Task.CompletedTask;
+    }
 
     /// <summary>
     /// GetColor

src/BootstrapBlazor/Components/Console/Console.razor

@@ -47,7 +47,8 @@
             }
             @if (OnClear != null)
             {
-                <Button Text="@ClearButtonText" Icon="@ClearButtonIcon" Color="@ClearButtonColor" OnClick="ClearConsole" class="console-clear" />
+                <Button Text="@ClearButtonText" Icon="@ClearButtonIcon" Color="@ClearButtonColor"
+                        OnClick="OnClearConsole" class="console-clear"></Button>
             }
         </div>
     }

src/BootstrapBlazor/Components/Console/Console.razor.cs

@@ -121,7 +121,7 @@ public partial class Console
     /// 获得/设置 清空委托方法
     /// </summary>
     [Parameter]
-    public Action? OnClear { get; set; }
+    public Func<Task>? OnClear { get; set; }
 
     /// <summary>
     /// 获得/设置 组件高度 默认为 126px;
@@ -150,7 +150,7 @@ public partial class Console
     /// <summary>
     /// 获得 是否显示 Footer
     /// </summary>
-    protected bool ShowFooter => OnClear != null || ShowAutoScroll || FooterTemplate != null;
+    private bool ShowFooter => OnClear != null || ShowAutoScroll || FooterTemplate != null;
 
     [Inject]
     [NotNull]
@@ -194,8 +194,11 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
     /// <summary>
     /// 清空控制台消息方法
     /// </summary>
-    public void ClearConsole()
+    public async Task OnClearConsole()
     {
-        OnClear?.Invoke();
+        if (OnClear != null)
+        {
+            await OnClear();
+        }
     }
 }

test/UnitTest/Components/ConsoleTest.cs

@@ -52,7 +52,7 @@ public void Items_OK()
     }
 
     [Fact]
-    public void OnClear_OK()
+    public async Task OnClear_OK()
     {
         var clearClicked = false;
         var cut = Context.RenderComponent<Console>(builder =>
@@ -66,13 +66,14 @@ public void OnClear_OK()
         Assert.False(clearClicked);
 
         // 实例触发 OnClear 方法
-        cut.Instance.ClearConsole();
+        await cut.Instance.OnClearConsole();
 
         cut.SetParametersAndRender(pb =>
         {
-            pb.Add(a => a.OnClear, new Action(() =>
+            pb.Add(a => a.OnClear, new Func<Task>(() =>
             {
                 clearClicked = true;
+                return Task.CompletedTask;
             }));
         });
         cut.Find(".btn-secondary").Click();
@@ -88,7 +89,7 @@ public void ClearButtonText_OK()
             {
                 new() { Message = "Test1" }, new() { Message = "Test2" }
             });
-            builder.Add(a => a.OnClear, new Action(() => { }));
+            builder.Add(a => a.OnClear, () => Task.CompletedTask);
             builder.Add(a => a.ClearButtonText, "Console Clear");
         });
 
@@ -104,7 +105,7 @@ public void OnClearButtonText_OK()
             {
                 new() { Message = "Test1" }, new() { Message = "Test2" }
             });
-            builder.Add(a => a.OnClear, new Action(() => { }));
+            builder.Add(a => a.OnClear, () => Task.CompletedTask);
             builder.Add(a => a.ClearButtonIcon, "fa-solid fa-xmark");
         });
 
@@ -121,7 +122,7 @@ public void ClearButtonColor_OK()
             {
                 new() { Message = "Test1" }, new() { Message = "Test2" }
             });
-            builder.Add(a => a.OnClear, new Action(() => { }));
+            builder.Add(a => a.OnClear, () => Task.CompletedTask);
             builder.Add(a => a.ClearButtonColor, Color.Primary);
         });