feat(IContextMenuItem): add IsShow parameter (#7608)

* #7605
增加上下文菜单项反排序。
增加 TrimStartAndEndDivider 参数，确定开始及结尾菜单项不是分割线。

* 调整代码覆盖度。

* feat(ContextMenuItem): add IsShow parameter

* Revert "调整代码覆盖度。"

This reverts commit df336ea.

* Revert "#7605"

This reverts commit 538e7b8.

* refactor: 更新 IsShow 逻辑

* test: 增加单元测试

* chore: bump version 10.3.1-beta02

---------

Co-authored-by: AiYuZhen <aizhen@aizhen.vip>
Co-authored-by: Argo Zhang <argo@live.ca>

Author: 3 people

src/BootstrapBlazor/BootstrapBlazor.csproj

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

src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor

@@ -1,4 +1,4 @@
-@namespace BootstrapBlazor.Components
+@namespace BootstrapBlazor.Components
 @inherits BootstrapModuleComponentBase
 @attribute [BootstrapModuleAutoLoader]
 
@@ -7,7 +7,7 @@
         @ChildContent
     </CascadingValue>
     <RenderTemplate>
-        @foreach (var context in _contextMenuItems)
+        @foreach (var context in _contextMenuItems.Where(i => i.IsShow))
         {
             if (context is ContextMenuDivider)
             {

src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs

@@ -13,6 +13,13 @@ namespace BootstrapBlazor.Components;
 /// </summary>
 public class ContextMenuDivider : Divider, IContextMenuItem, IDisposable
 {
+    /// <summary>
+    /// <inheritdoc cref="IContextMenuItem.IsShow"/>
+    /// </summary>
+    /// <remarks>一般是通过业务逻辑判断是否显示</remarks>
+    [Parameter]
+    public bool IsShow { get; set; } = true;
+
     [CascadingParameter]
     [NotNull]
     private ContextMenu? ContextMenu { get; set; }

src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs

@@ -51,6 +51,13 @@ public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
     [Parameter]
     public Func<ContextMenuItem, object?, Task>? OnClick { get; set; }
 
+    /// <summary>
+    /// <inheritdoc cref="IContextMenuItem.IsShow"/>
+    /// </summary>
+    /// <remarks>一般是通过业务逻辑判断是否显示</remarks>
+    [Parameter]
+    public bool IsShow { get; set; } = true;
+
     [CascadingParameter]
     [NotNull]
     private ContextMenu? ContextMenu { get; set; }

src/BootstrapBlazor/Components/ContextMenu/IContextMenuItem.cs

@@ -11,5 +11,10 @@ namespace BootstrapBlazor.Components;
 /// </summary>
 public interface IContextMenuItem
 {
-
+    /// <summary>
+    /// <para lang="zh">获得/设置 是否显示，默认为 true 显示</para>
+    /// <para lang="en">Gets or sets whether to display. Default is true</para>
+    /// </summary>
+    /// <remarks>一般是通过业务逻辑判断是否显示</remarks>
+    bool IsShow { get; set; }
 }

test/UnitTest/Components/ContextMenuTest.cs

@@ -107,6 +107,36 @@ public async Task ContextMenu_Ok()
         Assert.True(clicked);
     }
 
+    [Theory]
+    [InlineData(true, true)]
+    [InlineData(false, false)]
+    public void IsShow_Ok(bool show, bool expected)
+    {
+        var cut = Context.Render<ContextMenuZone>(pb =>
+        {
+            pb.AddChildContent<ContextMenu>(pb =>
+            {
+                pb.AddChildContent<ContextMenuItem>(pb =>
+                {
+                    pb.Add(a => a.Icon, "fa fa-test");
+                    pb.Add(a => a.Text, "Test1");
+                    pb.Add(a => a.IsShow, show);
+                });
+                pb.AddChildContent<ContextMenuDivider>(pb =>
+                {
+                    pb.Add(a => a.IsShow, show);
+                });
+                pb.AddChildContent<ContextMenuItem>(pb =>
+                {
+                    pb.Add(a => a.Icon, "fa fa-test");
+                    pb.Add(a => a.Text, "Test2");
+                });
+            });
+        });
+        var actual = cut.Markup.Contains("Test1");
+        Assert.Equal(expected, actual);
+    }
+
     [Fact]
     public async Task ContextMenu_TouchWithTimeout_Ok()
     {