feat(ListView): add EmptyText parameter (#5287)

* refactor: 过滤掉超时异常

* refactor: 更新代码

* test: 更新单元测试

* refactor: 增加 LoadModuleByName 扩展方法

* refactor: 使用新的扩展方法减少代码

* feat: 增加 EmptyTemplate 参数

* test: 增加单元测试

* refactor: 删除合并导致的冗余代码

---------

Co-authored-by: caics <[email protected]>

Author: ArgoZhang

src/BootstrapBlazor/Components/ListView/ListView.razor

@@ -10,43 +10,54 @@
         </div>
     }
     <div class="@BodyClassString">
-        @if (BodyTemplate != null)
+        @if (Rows.Count > 0)
         {
-            if (GroupName == null)
+            if (BodyTemplate != null)
             {
-                foreach (var item in Rows)
+                if (GroupName == null)
                 {
-                    <div class="listview-item" @onclick="@(e => OnClick(item))">
-                        @BodyTemplate(item)
-                    </div>
+                    foreach (var item in Rows)
+                    {
+                        <div class="listview-item" @onclick="@(e => OnClick(item))">
+                            @BodyTemplate(item)
+                        </div>
+                    }
                 }
-            }
-            else if (Collapsible)
-            {
-                <Collapse IsAccordion="IsAccordion" OnCollapseChanged="OnCollapseChanged!">
-                    <CollapseItems>
-                        @RenderCollapsibleItems(GroupName)
-                    </CollapseItems>
-                </Collapse>
-            }
-            else
-            {
-                foreach (var key in GetGroupItems(GroupName))
+                else if (Collapsible)
                 {
-                    <div @key="@key.GroupName" class="accordion-item">
-                        <div class="accordion-header">@key.GroupName</div>
-                        <div class="accordion-body">
-                            @foreach (var item in key.Items)
-                            {
-                                <div class="listview-item" @onclick="@(e => OnClick(item))">
-                                    @BodyTemplate(item)
-                                </div>
-                            }
+                    <Collapse IsAccordion="IsAccordion" OnCollapseChanged="OnCollapseChanged!">
+                        <CollapseItems>
+                            @RenderCollapsibleItems(GroupName)
+                        </CollapseItems>
+                    </Collapse>
+                }
+                else
+                {
+                    foreach (var key in GetGroupItems(GroupName))
+                    {
+                        <div @key="@key.GroupName" class="accordion-item">
+                            <div class="accordion-header">@key.GroupName</div>
+                            <div class="accordion-body">
+                                @foreach (var item in key.Items)
+                                {
+                                    <div class="listview-item" @onclick="@(e => OnClick(item))">
+                                        @BodyTemplate(item)
+                                    </div>
+                                }
+                            </div>
                         </div>
-                    </div>
+                    }
                 }
             }
         }
+        else if (EmptyTemplate != null)
+        {
+            @EmptyTemplate
+        }
+        else
+        {
+            @EmptyText
+        }
     </div>
     @if (FooterTemplate != null || Pageable)
     {

src/BootstrapBlazor/Components/ListView/ListView.razor.cs

@@ -128,6 +128,18 @@ public partial class ListView<TItem> : BootstrapComponentBase
     [Parameter]
     public string? Height { get; set; }
 
+    /// <summary>
+    /// 获得/设置 无数据时模板 默认 null 未设置
+    /// </summary>
+    [Parameter]
+    public RenderFragment? EmptyTemplate { get; set; }
+
+    /// <summary>
+    /// 获得/设置 无数据时显示文字 默认 null 未设置使用资源文件设置文字
+    /// </summary>
+    [Parameter]
+    public string? EmptyText { get; set; }
+
     /// <summary>
     /// 获得/设置 当前页码
     /// </summary>

test/UnitTest/Components/ListViewTest.cs

@@ -14,7 +14,7 @@ public void Items_Ok()
         {
             pb.Add(a => a.BodyTemplate, p => builder => builder.AddContent(0, $"{p.ImageUrl}-{p.Description}-{p.Category}"));
         });
-        cut.Markup.Contains("listview-body");
+        cut.Contains("listview-body");
     }
 
     [Fact]
@@ -24,7 +24,7 @@ public void Height_Ok()
         {
             pb.Add(a => a.Height, "50vh");
         });
-        cut.Markup.Contains("style=\"height: 50vh;\"");
+        cut.Contains("style=\"height: 50vh;\"");
     }
 
     [Fact]
@@ -293,6 +293,32 @@ public void OnCollapseChanged_Ok()
         });
     }
 
+    [Fact]
+    public void EmptyTemplate_Ok()
+    {
+        var cut = Context.RenderComponent<ListView<Product>>(pb =>
+        {
+            pb.Add(a => a.OnQueryAsync, option =>
+            {
+                var ret = new QueryData<Product>()
+                {
+                    Items = [],
+                    TotalCount = 0
+                };
+                return Task.FromResult(ret);
+            });
+            pb.Add(a => a.EmptyTemplate, builder => builder.AddContent(0, "empty-template"));
+        });
+        cut.Contains("empty-template");
+
+        cut.SetParametersAndRender(pb =>
+        {
+            pb.Add<RenderFragment?>(a => a.EmptyTemplate, null);
+            pb.Add(a => a.EmptyText, "text-empty");
+        });
+        cut.Contains("text-empty");
+    }
+
     private class Product
     {
         public string? ImageUrl { get; set; }