feat(DrawerOption): add BodyContext parameter (#5112)

* feat(Drawer): 增加 BodyContext 参数

* test: 增加单元测试

* chore: bump version 9.2.8-beta02

* test: 更新单元测试

Co-Authored-By: Argo <[email protected]>

Author: ArgoZhang

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>9.2.8-beta01</Version>
+    <Version>9.2.8-beta02</Version>
   </PropertyGroup>
 
   <ItemGroup>

src/BootstrapBlazor/Components/Drawer/Drawer.razor

@@ -10,8 +10,10 @@
     }
     <div tabindex="-1" class="@DrawerClassString" style="@DrawerStyleString" @onclick:stopPropagation>
         <div class="drawer-content">
-            <CascadingValue Value="Close" IsFixed=" true">
-                @ChildContent
+            <CascadingValue Name="BodyContext" Value="BodyContext" IsFixed="true">
+                <CascadingValue Value="Close" IsFixed=" true">
+                    @ChildContent
+                </CascadingValue>
             </CascadingValue>
         </div>
         @if (AllowResize)

src/BootstrapBlazor/Components/Drawer/Drawer.razor.cs

@@ -113,6 +113,12 @@ public partial class Drawer
     [Parameter]
     public Func<Task>? OnCloseAsync { get; set; }
 
+    /// <summary>
+    /// 获得/设置 抽屉内容相关数据 多用于传值
+    /// </summary>
+    [Parameter]
+    public object? BodyContext { get; set; }
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>

src/BootstrapBlazor/Components/Drawer/DrawerContainer.cs

@@ -88,6 +88,10 @@ private Dictionary<string, object> GetParameters(DrawerOption option)
         {
             parameters.Add(nameof(Drawer.OnClickBackdrop), option.OnClickBackdrop);
         }
+        if (option.BodyContext != null)
+        {
+            parameters.Add(nameof(Drawer.BodyContext), option.BodyContext);
+        }
         return parameters;
     }
 

src/BootstrapBlazor/Components/Drawer/DrawerOption.cs

@@ -64,4 +64,9 @@ public class DrawerOption
     /// 获得/设置 关闭当前 Drawer 回调委托 默认 null
     /// </summary>
     public Func<Task>? OnCloseAsync { get; set; }
+
+    /// <summary>
+    /// 获得/设置 相关连数据，多用于传值使用
+    /// </summary>
+    public object? BodyContext { get; set; }
 }

test/UnitTest/Components/DrawerTest.cs

@@ -106,6 +106,25 @@ public void ChildContent_Ok()
         Assert.NotNull(button);
     }
 
+    [Fact]
+    public void BodyContext_Ok()
+    {
+        var cut = Context.RenderComponent<Drawer>(builder =>
+        {
+            builder.Add(a => a.BodyContext, "test-body-context");
+            builder.Add(a => a.ChildContent, s =>
+            {
+                s.OpenComponent<MockContent>(0);
+                s.CloseComponent();
+            });
+        });
+
+        var component = cut.FindComponent<MockContent>();
+        Assert.NotNull(component);
+
+        Assert.Equal("test-body-context", component.Instance.GetBodyContext());
+    }
+
     [Fact]
     public void ShowBackdrop_Ok()
     {
@@ -141,4 +160,13 @@ public void Position_Ok()
         });
         cut.Contains("--bb-drawer-position: absolute;");
     }
+
+    class MockContent : ComponentBase
+    {
+        [CascadingParameter(Name = "BodyContext")]
+        [NotNull]
+        private object? BodyContext { get; set; }
+
+        public string? GetBodyContext() => BodyContext.ToString();
+    }
 }

test/UnitTest/Services/DrawerServiceTest.cs

@@ -22,7 +22,8 @@ public async Task Show_Ok()
             OnClickBackdrop = () => Task.CompletedTask,
             OnCloseAsync = () => Task.CompletedTask,
             Placement = Placement.Bottom,
-            ShowBackdrop = true
+            ShowBackdrop = true,
+            BodyContext = "test-body-context"
         };
         var service = Context.Services.GetRequiredService<DrawerService>();
         var cut = Context.RenderComponent<BootstrapBlazorRoot>();