feat(ModalDialog): add constraints between parameters (#5471)

* refactor: 增加文档注释

* feat: 增加参数约束逻辑

* test: 更新单元测试

Author: ArgoZhang

src/BootstrapBlazor/Components/Dialog/DialogOption.cs

@@ -33,11 +33,13 @@ public class DialogOption
     /// <summary>
     /// 获得/设置 全屏弹窗 默认 None
     /// </summary>
+    /// <remarks>为保证功能正常，设置值后 <see cref="ShowMaximizeButton"/> <seealso cref="ShowResize"/> <seealso cref="IsDraggable"/> 均不可用</remarks>
     public FullScreenSize FullScreenSize { get; set; } = FullScreenSize.None;
 
     /// <summary>
     /// 获得/设置 是否显示最大化按钮 默认 false 不显示
     /// </summary>
+    /// <remarks>为保证功能正常，设置值为 true 后 <seealso cref="ShowResize"/> <seealso cref="IsDraggable"/> 均不可用</remarks>
     public bool ShowMaximizeButton { get; set; }
 
     /// <summary>

src/BootstrapBlazor/Components/Modal/ModalDialog.razor.cs

@@ -61,6 +61,7 @@ public partial class ModalDialog : IHandlerException
     /// <summary>
     /// 获得/设置 弹窗大小 默认为 <see cref="FullScreenSize.None"/>
     /// </summary>
+    /// <remarks>为保证功能正常，设置值后 <see cref="ShowMaximizeButton"/> <seealso cref="ShowResize"/> <seealso cref="IsDraggable"/> 均不可用</remarks>
     [Parameter]
     public FullScreenSize FullScreenSize { get; set; }
 
@@ -85,6 +86,7 @@ public partial class ModalDialog : IHandlerException
     /// <summary>
     /// 获得/设置 是否显示最大化按钮 默认为 false
     /// </summary>
+    /// <remarks>为保证功能正常，设置值为 true 后 <seealso cref="ShowResize"/> <seealso cref="IsDraggable"/> 均不可用</remarks>
     [Parameter]
     public bool ShowMaximizeButton { get; set; }
 
@@ -329,6 +331,18 @@ protected override void OnParametersSet()
         ExportPdfButtonOptions.Icon ??= IconTheme.GetIconByKey(ComponentIcons.TableExportPdfIcon);
 
         MaximizeIconString = MaximizeWindowIcon;
+
+        if (FullScreenSize != FullScreenSize.None)
+        {
+            ShowMaximizeButton = false;
+            ShowResize = false;
+            IsDraggable = false;
+        }
+        else if (ShowMaximizeButton)
+        {
+            ShowResize = false;
+            IsDraggable = false;
+        }
     }
 
     /// <summary>

test/UnitTest/Components/DialogTest.cs

@@ -64,7 +64,9 @@ await cut.InvokeAsync(() => dialog.Show(new DialogOption()
                 return Task.CompletedTask;
             }
         }));
-        Assert.Contains("<svg", cut.Markup);
+
+        // 由于设置了 ShowMaximizeButton 导致 ShowResize 参数失效
+        Assert.DoesNotContain("<svg", cut.Markup);
         Assert.Contains("data-bs-backdrop=\"static\"", cut.Markup);
 
         // 全屏按钮