feat(CheckboxListGeneric): add ItemTemplate parameter (#5255)

* chore: bump version 9.3.1-beta05

* feat: 增加 ItemTemplate 支持

* test: 增加单元测试

Author: ArgoZhang

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>9.3.1-beta04</Version>
+    <Version>9.3.1-beta05</Version>
   </PropertyGroup>
 
   <ItemGroup>

src/BootstrapBlazor/Components/Checkbox/CheckboxListGeneric.razor

@@ -29,7 +29,8 @@ else
                 <Checkbox TValue="bool" IsDisabled="GetDisabledState(item)"
                           ShowAfterLabel="true" ShowLabel="false" ShowLabelTooltip="ShowLabelTooltip"
                           DisplayText="@item.Text" OnBeforeStateChanged="_onBeforeStateChangedCallback!"
-                          Value="@item.Active" OnStateChanged="@((_, v) => OnStateChanged(item, v))"></Checkbox>
+                          Value="@item.Active" OnStateChanged="@((_, v) => OnStateChanged(item, v))"
+                          ChildContent="GetChildContent(item)"></Checkbox>
             </div>
         }
     </div>

src/BootstrapBlazor/Components/Checkbox/CheckboxListGeneric.razor.cs

@@ -110,6 +110,12 @@ public partial class CheckboxListGeneric<TValue> : IModelEqualityComparer<TValue
     [Parameter]
     public Func<Task>? OnMaxSelectedCountExceed { get; set; }
 
+    /// <summary>
+    /// 获得/设置 项模板
+    /// </summary>
+    [Parameter]
+    public RenderFragment<SelectedItem<TValue>>? ItemTemplate { get; set; }
+
     /// <summary>
     /// 获得 当前选项是否被禁用
     /// </summary>
@@ -216,6 +222,10 @@ private async Task OnStateChanged(SelectedItem<TValue> item, bool v)
     /// </summary>
     private Task OnClick(SelectedItem<TValue> item) => OnStateChanged(item, !item.Active);
 
+    private RenderFragment? GetChildContent(SelectedItem<TValue> item) => ItemTemplate == null
+        ? null
+        : ItemTemplate(item);
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>

test/UnitTest/Components/CheckboxListGenericTest.cs

@@ -252,6 +252,27 @@ await cut.InvokeAsync(async () =>
         Assert.False(max);
     }
 
+    [Fact]
+    public void ItemTemplate_Ok()
+    {
+        var items = new List<SelectedItem<Foo>>()
+        {
+            new(new Foo() { Id = 1, Name = "Test1" }, "Test 1"),
+            new(new Foo() { Id = 2, Name = "Test2" }, "Test 2"),
+            new(new Foo() { Id = 3, Name = "Test3" }, "Test 3")
+        };
+        var cut = Context.RenderComponent<CheckboxListGeneric<Foo>>(pb =>
+        {
+            pb.Add(a => a.Items, items);
+            pb.Add(a => a.ItemTemplate, foo => builder =>
+            {
+                builder.AddContent(0, foo.Text);
+            });
+        });
+        var labels = cut.FindAll(".checkbox-item .form-check-label");
+        Assert.Equal(3, labels.Count);
+    }
+
     private class Dummy
     {
         [Required]