Ant Design Blazor Modal 模态对话框完整指南:声明式组件、ModalService 与 ConfirmService 实战

原创2026-10-11 10:24:542,232 阅读
文章标签:前端UI组件设计系统WebAssembly

Ant Design Blazor Modal 模态对话框完整指南:声明式组件、ModalService 与 ConfirmService 实战

模态对话框(Modal)是 Ant Design Blazor 组件库中承担"用户反馈与事务确认"的核心组件:它既可以通过 <Modal> 标签以声明式方式在当前页面正中弹出浮层承载表单与操作,也可以通过 ModalService / ConfirmService 以命令式编程方式(类似 WinForm 中 MessageBox 的体验)随时弹出确认框。阅读本文后,你将掌握 Modal 全部公开参数的语义与默认值、三种弹窗编程模式的选型与代码写法、如何通过返回的 ModalRef / ConfirmRef 引用动态更新与销毁弹窗,以及路由场景下批量销毁确认框的正确姿势。

本文以仓库中的官方文档 site/AntDesign.Docs/Demos/Components/Modal/doc/index.zh-CN.md 为主体脉络,并结合 components/modal 目录下的源码实现(Modal.razor.cs、ModalServiceForConfirm.cs、ConfirmService.cs、ConfirmOptions.cs 等)进行逐项印证与深度讲解。

何时使用 Modal

官方文档给出了两条核心使用场景:

  • 需要用户处理事务,又不希望跳转页面以致打断工作流程:此时用 Modal 在当前页面正中打开一个浮层,承载相应的操作。典型的落地场景包括"表单录入"(见 Demo FormInModal.razor)和"富内容展示"。
  • 需要一个简洁的确认框询问用户:此时可以直接使用 ModalService.Confirm() 等语法糖方法,无需手动编写浮层结构。

这两条场景在源码中分别对应两条实现路径:声明式的 <Modal> 组件(Modal.razor)与命令式的服务层(ModalService / ConfirmService)。ModalService 创建的是固定带 OK-Cancel 按钮的对话框,而 ConfirmService 则能返回"点了哪个按钮"的枚举结果,二者的取舍详见下文。

环境准备:容器与依赖注入

在使用 ModalService / ConfirmService 之前,必须完成两件基础配置(这也是文档中特别强调的前提):

  1. 在 App.Razor 中添加 <AntContainer /> 组件。查看 AntContainer.razor 的源码可以看到,它内部渲染了 Notification、Message、ComfirmContainer、DrawerContainer、ModalContainer、ImagePreviewContainer 等所有全局浮层容器,ModalService 创建的对话框正是挂载到 ModalContainer 上的,缺少它命令式弹窗将无法渲染。

  2. 通过 AddAntDesign() 注册服务。ServiceCollectionExtensions.cs 中按 WebAssembly 与 Server 的不同运行环境分别以 Singleton / Scoped 生命周期注册了 ModalService 与 ConfirmService,并同时注册了接口形式 IConfirmService。因此在 Razor 组件中既可以 @inject ModalService ModalService,也可以 @inject IConfirmService _confirmService。

// Program.cs
builder.Services.AddAntDesign();
@* App.Razor *@
<AntContainer />

<Modal> 组件完整参数手册

文档中列出了 Modal 组件公开的全部参数。结合 Modal.razor.cs 的源码,各参数的语义、默认值与底层实现说明如下:

参数 说明 类型 默认值
AfterClose Modal 关闭后的回调 EventCallback -
AfterOpen Modal 打开后的回调(源码中额外提供) EventCallback -
BodyStyle Modal body 样式 string -
CancelText 取消按钮文字,可覆盖 Locale 中默认值 string|RenderFragment Cancel
CancelButtonProps cancel 按钮 props ButtonProps -
Centered 垂直居中展示 Modal bool false
Closable 是否显示右上角的关闭按钮 bool true
CloseIcon 自定义关闭图标 RenderFragment close-outline 图标
ConfirmLoading 确定按钮 loading bool false
DestroyOnClose 关闭时销毁 Modal 里的子元素 bool false
Draggable 是否允许通过 Header 拖动 Modal(若为 true,Title 和 TitleTemplate 至少有一个必须有值) bool false
DragInViewport Draggable 为 true 时,是否仅在视窗内拖动 bool true
Header 头部内容,不需要头部时可设为 null RenderFragment ModalHeader
Footer 底部内容,不需要默认底部按钮时可设为 null string|RenderFragment 确定取消按钮
ForceRender 打开前强制渲染 Modal DOM bool false
GetContainer 指定 Modal 挂载的 HTML 节点,false 为挂载在当前 dom ElementReference? document.body
Keyboard 是否支持键盘 esc 关闭 bool true
Mask 是否展示遮罩 bool true
MaskClosable 点击蒙层是否允许关闭 bool true
MaskStyle 遮罩样式 string -
MaxBodyHeight Modal 内容的最大高度 string? null
Maximizable 是否显示最大化按钮 bool false
MaximizeBtnIcon 正常状态下的最大化按钮 icon RenderFragment fullscreen
RestoreBtnIcon 最大化状态下的还原按钮 icon RenderFragment fullscreen-exit
DefaultMaximized 初始化时即为最大化状态(会忽略 Maximizable 值) bool false
OkText 确认按钮文字,可覆盖 Locale 中默认值 string|RenderFragment OK
OkType 确认按钮类型 string primary
OkButtonProps ok 按钮 props ButtonProps -
Resizable 是否可以对 Modal 进行水平方向大小调整 bool false
Style 设置浮层的样式,调整浮层位置等 string -
Title 标题,若 TitleTemplate 不为 null 则优先显示 TitleTemplate string null
TitleTemplate 标题(RenderFragment 形式) RenderFragment null
Visible 对话框是否可见 bool -
VisibleChanged Visible 变化时的回调(用于 @bind-Visible) EventCallback -
Width 宽度 string|double 520
WrapClassName 对话框外层容器的类名 string -
ZIndex 设置 Modal 的 z-index int 1000
OnCancel 点击遮罩层、右上角叉或取消按钮的回调 EventCallback<MouseEventArgs> -
OnOk 点击确定回调 EventCallback<MouseEventArgs> -

源码层面有几个值得注意的细节:

  • Width 是 OneOf<string, double> 联合类型:传入数字 520 时,Modal.razor.cs 的 GetWidth() 会自动格式化为 "520px",传入字符串则按 CSS 原样透传,所以 Width="80%" 同样合法。
  • 按钮文字会回退到 Locale:CancelText ?? Locale.CancelText、OkText ?? Locale.OkText,见 Modal.razor.cs。这意味着不传按钮文字时,实际文案由 ModalLocale(随 locales 中的语言包切换)决定,而不是写死的英文。
  • 默认关闭图标/最大化图标定义在 DialogOptionsBase.cs:默认关闭图标为 close(outline 主题)、最大化图标为 fullscreen、还原图标为 fullscreen-exit,均可通过 CloseIcon / MaximizeBtnIcon / RestoreBtnIcon 替换。
  • ConfirmLoading 在服务模式下的实现:在 ModalOptions.cs 中,ConfirmLoading 实际读写的是 OkButtonProps.Loading,即它是对确定按钮 loading 状态的一层语法糖。

声明式用法示例

最基础的用法(来自 Basic.razor):

<Button Type="ButtonType.Primary" OnClick="@(() => { _visible = true; })">
    Open Modal
</Button>

<Modal Title="BasicModal" @bind-Visible="_visible">
    <p>Some contents...</p>
    <p>Some contents...</p>
    <p>Some contents...</p>
</Modal>

@code {
    bool _visible = false;
}

启用拖拽、限制视窗内拖拽、垂直居中(来自 DraggableModal.razor):

<Modal Title="@("DraggableModal")"
       @bind-Visible="_visible1"
       Draggable="@(true)"
       Centered
       OnOk="(e) => { _visible1 = false; }"
       OnCancel="(e) => { _visible1 = false; }">
    <p>Some contents...</p>
</Modal>

<Modal Title="@("DraggableModal")"
       @bind-Visible="_visible2"
       Draggable="@(true)"
       DragInViewport="@(false)"
       OnOk="(e) => { _visible2 = false; }"
       OnCancel="(e) => { _visible2 = false; }">
    <p>Some contents...</p>
</Modal>

注意 Draggable="true" 时文档与源码都要求 Title 或 TitleTemplate 至少其一有值——因为拖动事件是挂在标题栏区域上的,没有标题就没有可拖拽的把手。

启用最大化,并默认以最大化状态打开(来自 Maxable.razor):

<Modal Title="BasicModal"
       @bind-Visible="_visible"
       Maximizable="@true"
       Centered="@true"
       DefaultMaximized="@true">
    <p>Some contents...</p>
</Modal>

注意:关闭后状态默认不重置

<Modal /> 默认关闭后状态不会自动清空,如果希望每次打开都是新内容,请设置 DestroyOnClose。

这一点是文档反复强调的关键行为:Modal 关闭后默认不会从 DOM 中移除,因此内部组件实例会被保留、其 Dispose 不会触发。设置 DestroyOnClose="true" 后,关闭时会卸载子组件,从而保证每次打开都是全新内容、也会正确触发子组件生命周期。

ModalService:命令式创建 Confirm 与 Modal

ModalService 是文档中的第二套核心 API,按用途分为两组:

1. 创建 Confirm dialog

  • ModalService.Info
  • ModalService.Success
  • ModalService.Error
  • ModalService.Warning
  • ModalService.Confirm
  • ModalService.CreateAsync
  • ModalService.ConfirmAsync
  • ModalService.InfoAsync
  • ModalService.SuccessAsync
  • ModalService.ErrorAsync
  • ModalService.WarningAsync
  • ModalService.UpdateConfirmAsync
  • ModalService.DestroyConfirmAsync
  • ModalService.DestroyAllConfirmAsync
  • ModalService.CreateConfirmAsync

请确认已经在 App.Razor 中添加了 <AntContainer /> 组件。 ConfirmAsync、InfoAsync、SuccessAsync、ErrorAsync、WarningAsync 返回值为 Task<bool>,可用于判断用户点击的按钮是 OK 按钮(true)还是 Cancel 按钮(false)。

从源码 ModalServiceForConfirm.cs 可以看到这两组方法的分工:

  • Confirm / Info / Success / Error / Warning(同步版):内部创建 ConfirmRef 并初始化 TaskCompletionSource<ConfirmResult>,然后通过 OnConfirmOpenEvent 事件通知 ComfirmContainer 完成渲染,立即返回 ConfirmRef 供调用方持有(ModalServiceForConfirm.cs)。其中 Info/Success/Error/Warning 会先设置对应的 ConfirmIcon 并默认关闭 Cancel 按钮(OkCancel = false)。
  • ConfirmAsync 等(异步版):在同步逻辑基础上 await confirmRef.TaskCompletionSource.Task,并通过 ContinueWith(t => t.Result == ConfirmResult.OK) 将 ConfirmResult 归一化为 Task<bool>,从而让调用方可以像"等一个异步结果"那样拿到用户的选择(ModalServiceForConfirm.cs)。

同步版配合引用对象的典型用法(来自 Manual.razor,展示"倒计时关闭"场景):

@inject ModalService _modalService

private async Task CountDown()
{
    var secondsToGo = 5;
    var props = new ConfirmOptions()
    {
        Title = "This is a notification message",
        Content = $"This modal will be destroyed after {secondsToGo} second."
    };
    var modelRef = _modalService.Success(props);
    while (secondsToGo > 0)
    {
        secondsToGo -= 1;
        await Task.Delay(1000);
        props.Content = $"This modal will be destroyed after {secondsToGo} second.";
        await modelRef.UpdateConfigAsync();   // 更新弹窗内容
    }
    await _modalService.DestroyConfirmAsync(modelRef);  // 销毁弹窗
}

阻塞式确认(来自 Confirm.razor):

private async Task BlockingConfirm()
{
    var isTrue = await _modalService.ConfirmAsync(new ConfirmOptions()
    {
        Content = "Here is a blocking confirm, you can get OK or cancel button is click",
        Title = "Info"
    });
    _message.Info($"The confirm return {isTrue}");
}

文档中给出的引用通用操作模式如下,UpdateConfirmAsync 用于更新已打开的确认框,DestroyConfirmAsync 用于主动关闭:

ConfirmOptions config = new ConfirmOptions();
var modelRef = await ModalService.Info(config);

modelRef.UpdateConfirmAsync();

ModalService.DestroyConfirmAsync(modelRef);

2. 创建 Modal dialog

  • ModalService.CreateModalAsync

源码 ModalServiceForModal.cs 提供了一套完整的泛型重载,支持携带自定义模板组件:

  • CreateModal(ModalOptions options):创建普通 Modal。
  • CreateModal<TResult>(ModalOptions options):创建并返回 ModalRef<TResult>,用于接收模板组件回传的结果。
  • CreateModal<TComponent, TComponentOptions>(ModalOptions options, TComponentOptions componentOptions):创建携带模板组件 TComponent(须继承 FeedbackComponent<TComponentOptions>)的 Modal,componentOptions 作为模板的 Options 属性传入。
  • CreateModal<TComponent, TComponentOptions, TResult>(...):额外支持模板向调用方回传 TResult 类型结果。
  • 对应的 CreateModalAsync 系列已标记 [Obsolete],文档与源码都推荐直接使用无 Async 后缀的新版本(它们本身就是同步创建)。

模板 Modal 的完整示例(来自 Modal_service_for_modal.razor):

@inject ModalService ModalService

<Button OnClick="OpenTemplate" Type="ButtonType.Primary">Use Template</Button>

@code {
    private string value = "blazor";
    private ModalRef _modalRef;

    private async Task OpenTemplate()
    {
        var templateOptions = new Form.demo.Basic.Model();
        templateOptions.Username = value;

        var modalConfig = new ModalOptions();
        modalConfig.Title = "Basic Form";
        modalConfig.OnCancel = async (e) =>
        {
            Console.WriteLine("OnCancel");
            await _modalRef.CloseAsync();
        };
        modalConfig.AfterClose = () =>
        {
            Console.WriteLine("AfterClose");
            value = templateOptions.Username;
            InvokeAsync(StateHasChanged);
            return Task.CompletedTask;
        };

        _modalRef = await ModalService
            .CreateModalAsync<ModalTemplateDemo, Form.demo.Basic.Model>
            (modalConfig, templateOptions);

        _modalRef.OnOpen = () => { /* 打开时回调 */ return Task.CompletedTask; };
        _modalRef.OnOk = () => { /* 点击确定回调 */ return Task.CompletedTask; };
        _modalRef.OnCancel = () => { /* 点击取消回调 */ return Task.CompletedTask; };
        _modalRef.OnClose = () => { /* 关闭时回调 */ return Task.CompletedTask; };
    }
}

带返回结果的模板 Modal 用法:

var modalConfig = new ModalOptions();
modalConfig.Title = "TemplateWithResult";
// 每次关闭后都销毁子组件,使 ConfirmTemplateDemo 的 Dispose 生效
modalConfig.DestroyOnClose = true;

var modalRef = await ModalService.CreateModalAsync<ConfirmTemplateDemo, string, string>(modalConfig, value);

modalRef.OnOk = (result) =>
{
    Console.WriteLine($"OnOk:{result}");   // result 为模板组件回传的 string
    return Task.CompletedTask;
};

这里同样印证了 FAQ 中"为什么 CreateModalAsync<> 创建的 Modal 关闭后自定义组件不执行 Dispose"的结论:Modal 关闭后默认不卸载子元素,必须显式设置 modalConfig.DestroyOnClose = true(示例源码中甚至为此专门写了注释)。

DestroyAllConfirmAsync:路由场景的批量销毁

ModalService.DestroyAllConfirmAsync() 可以一次性销毁所有弹出的确认窗(即上述 ModalService.Info、Success、Error、Warning、Confirm 创建的对话框)。它通常用于路由监听当中——处理路由前进、后退时确认对话框无法自动销毁的问题,避免在各处使用实例返回值逐个关闭。二者的分工:

  • ModalService.DestroyConfirmAsync(config):适用于主动关闭单个确认框(持有引用时)。
  • ModalService.DestroyAllConfirmAsync():适用于被动/批量关闭(如路由切换这类没有引用上下文的场景)。

源码层面,ModalServiceForConfirm.cs 中 DestroyAllConfirmAsync 通过 OnConfirmCloseAllEvent 事件广播关闭全部确认框。官方 Demo ConfirmRouter.razor 演示了"一次弹出 3 个确认框、再一键全部销毁"的典型用法:

private async Task DestroyAll()
{
    await _modalService.DestroyAllConfirmAsync();
}

private async Task ShowConfirm()
{
    RenderFragment icon = @<Icon Type="@IconType.Outline.ExclamationCircle" />;
    RenderFragment content = @<Button OnClick="DestroyAll"> Click to destroy all </Button>;

    for (int i = 0; i < 3; i++)
    {
        _modalService.Confirm(new ConfirmOptions()
        {
            Icon = icon,
            Content = content,
        });
        await Task.Delay(500);
    }
}

ConfirmService:WinForm MessageBox 风格的阻塞式确认

IConfirmService.Show 用于弹出类似于 WinForm 中 MessageBox 方式的对话框。它与 ModalService 的本质区别在于:

  • ModalService 只能创建固定带 OK-Cancel 按钮的对话框,并返回 ConfirmRef 对象或"是否点击了 OK 按钮"的布尔值;
  • ConfirmService 总是返回 ConfirmResult 枚举,精确指示哪个按钮被点击,同时支持多达三种按钮的排列组合。

从源码 ConfirmService.cs 看,Show 方法会构造 ConfirmOptions、根据 ConfirmButtons 配置按钮数量与文案,然后 await confirmRef.TaskCompletionSource.Task 阻塞等待用户点击,最后把 ConfirmResult 返回给调用方。

ConfirmButtons 枚举(ConfirmButtons.cs)支持的全部按钮组合:

枚举值 按钮组合
OK 仅一个 OK 按钮
OKCancel OK + Cancel
YesNo Yes + No
RetryCancel Retry + Cancel
AbortRetryIgnore Abort + Retry + Ignore
YesNoCancel Yes + No + Cancel

ConfirmResult 枚举(ConfirmResult.cs)取值:None = 0、OK = 1、Cancel = 2、Abort = 4、Retry = 8、Ignore = 16、Yes = 32、No = 64。

典型用法(来自 Confirm_Service.razor):

@inject IMessageService _message
@inject IConfirmService _confirmService

private async Task ShowConfirm(ConfirmButtons confirmButtons)
{
    var content = "Here is a blocking confirm, you can get OK or cancel button is click";
    var title = "Info";
    var confirmResult = await _confirmService.Show(content, title, confirmButtons);

    _message.Info($"{confirmResult} button is clicked", 2);
}

// 复杂按钮组合 + 自定义按钮属性
private async Task ShowAbortRetryIgnore()
{
    var confirmResult = await _confirmService.Show(
        content,
        title,
        ConfirmButtons.AbortRetryIgnore,
        ConfirmIcon.Error,
        new ConfirmButtonOptions()
        {
            Button1Props = new AntDesign.ButtonProps() { Type = AntDesign.ButtonType.Dashed },
            Button2Props = new AntDesign.ButtonProps() { Type = AntDesign.ButtonType.Primary, Disabled = true }
        });

    _message.Info($"{confirmResult} button is clicked", 2);
}

Show 方法有两个重载:简版只需 content、title(ConfirmButtons.OKCancel、ConfirmIcon.Info 为默认值);完整版额外支持 ConfirmButtonOptions(设置 Button1Props / Button2Props / Button3Props 三个按钮的属性)以及 autoFocusButton 参数。

ConfirmOptions 参数说明

ConfirmOptions(ConfirmOptions.cs)是配置确认框的核心类,文档参数表如下:

参数 说明 类型 默认值
AutoFocusButton 指定自动获得焦点的按钮 ConfirmAutoFocusButton ConfirmAutoFocusButton.Ok
CancelText 取消按钮文字,等价于 Button2Props.ChildContent string Cancel
Centered 垂直居中展示 Modal bool false
ClassName 容器(.ant-modal)类名 string -
Content 内容 string|RenderFragment -
Icon 自定义图标 RenderFragment -
MaskClosable 点击蒙层是否允许关闭 bool false(注意:与 Modal 的默认值相反)
OkText 确认按钮文字,等价于 Button1Props.ChildContent string|RenderFragment 确定
OkType 确认按钮类型,等价于 Button1Props.Type string primary
OkButtonProps ok 按钮 props,与 Button1Props 等价 ButtonProps -
CancelButtonProps cancel 按钮 props,与 Button2Props 等价 ButtonProps -
Title 标题,若 TitleTemplate 不为 null 则优先显示 TitleTemplate string null
TitleTemplate 标题 RenderFragment null
Width 宽度 string|double 416
ZIndex 设置 Modal 的 z-index int 1000
OnCancel 取消回调(仅 ModalService 创建的 Confirm 触发) EventCallback<MouseEventArgs>? null
OnOk 点击确定回调(仅 ModalService 创建的 Confirm 触发) EventCallback<MouseEventArgs>? null
Button1Props LTR 模式中最左侧按钮的属性 ButtonProps Type = ButtonType.Primary,ChildContent 与 ConfirmButtons 顺序相同
Button2Props LTR 模式中左边第二个按钮的属性 ButtonProps ChildContent 与 ConfirmButtons 顺序相同
Button3Props LTR 模式中左边第三个按钮的属性 ButtonProps ChildContent 与 ConfirmButtons 顺序相同

源码补充说明:

  • 构造默认值(ConfirmOptions.cs):Width = 416、Mask = true、MaskClosable = false(确认框默认不允许点击蒙层关闭,与 Modal 的 true 相反)、按钮文案取自 ConfirmLocale。
  • 按钮文字与 Props 的等价映射:OkText 本质是 Button1Props.ChildContent,CancelText 本质是 Button2Props.ChildContent,OkType 本质是 Button1Props.Type(ConfirmOptions.cs)。因此直接修改 Button1Props / Button2Props 与修改 OkText / OkType 是同一件事的两种写法。
  • 预设按钮组文案:BuildButtonsDefaultOptions()(ConfirmOptions.cs)会根据 ConfirmButtons 自动填充各组按钮的默认文案——OK、OKCancel、YesNo、YesNoCancel、RetryCancel、AbortRetryIgnore 均从 ConfirmLocale 读取,且 YesNoCancel 与 AbortRetryIgnore 的第二个按钮默认置为 Danger = true。
  • OnOk/OnCancel 的关闭控制:通过 ModalClosingEventArgs.Cancel 属性可阻止对话框关闭。官方 Demo ConfirmPromise.razor 展示了两种模式——在 OnOk 回调中延时 1 秒后默认关闭(不设置 Cancel),以及设置 e.Cancel = true 阻止关闭(常用于异步校验失败等场景):
private Func<ModalClosingEventArgs, Task> OnOkClick = async (e) =>
{
    await Task.Delay(1000);   // 延时后默认关闭
};

private Func<ModalClosingEventArgs, Task> OnNotOkClick = async (e) =>
{
    await Task.Delay(1000);
    e.Cancel = true;          // 阻止关闭
};
  • 上述函数调用后均会返回一个引用(ConfirmRef),可以通过该引用更新和关闭弹窗;ConfirmRef 的 Config 属性持有 ConfirmOptions,UpdateConfigAsync / CloseAsync / OpenAsync 对应更新、关闭、重新打开(见 ConfirmRef.cs)。

底层渲染机制速览

命令式弹窗之所以能"无声明而弹出",依赖的是事件驱动 + 全局容器:

  1. ModalService.Confirm(...) 等调用通过 OnConfirmOpenEvent 事件把 ConfirmRef 推给 ComfirmContainer;
  2. Confirm.razor 根据 Config.ConfirmButtons 的 switch 分支,用 BuildButton(Config.Button1Props / Button2Props / Button3Props, ...) 渲染出对应数量的按钮,并分别映射到 ConfirmResult.OK / Cancel / Yes / No / Retry / Abort / Ignore 结果;
  3. 用户点击按钮后,HandleBtn1Click / HandleBtn2Click / HandleBtn3Click 触发 TaskCompletionSource 完成,await 方随即拿到结果。

从样式角度看,Modal 与 Confirm 共用 components/modal/style 下的 modal.less 与 confirm.less,分别负责浮层布局(.ant-modal)与确认框专用布局(.ant-modal-confirm-*),并支持 rtl.less 的 RTL 模式。

FAQ:关闭后自定义组件为何不执行 Dispose

为什么通过 ModalService.CreateModalAsync<> 创建的 Modal,在关闭后,继承自 FeedbackComponent<> 的自定义组件不会执行 Dispose 方法?

原因:Modal 在关闭后默认不会从 DOM 中移除,因此自定义组件的 Dispose 方法不会被执行。

解决方案:设置 modalOptions.DestroyOnClose = true 来改变此默认行为。设置后关闭 Modal 时会将内容从渲染树中卸载,子组件生命周期得到完整执行。同样的原理也适用于声明式 <Modal DestroyOnClose="true"> 用法——如果希望每次打开都是全新内容(如表单重置),也应打开此开关。

小结

Ant Design Blazor 的 Modal 体系提供了三条由浅入深的弹窗路径,可按场景自由组合:

  1. 声明式 <Modal>:适合"常驻在当前页面结构中的浮层",通过 @bind-Visible 双向绑定控制显隐,完整覆盖 Draggable、Maximizable、Resizable、Centered 等交互增强;
  2. ModalService 命令式确认框:适合"随时随地的 OK/Cancel 确认",Confirm/Info/Success/Error/Warning 返回 ConfirmRef 便于更新销毁,ConfirmAsync 系列以 Task<bool> 优雅表达用户选择;
  3. ConfirmService 阻塞式确认框:最接近 WinForm MessageBox,支持最多三个按钮的任意组合(OK / OKCancel / YesNo / RetryCancel / AbortRetryIgnore / YesNoCancel),直接返回 ConfirmResult 精确告知点击了哪个按钮。

无论走哪条路径,都不要忘记两件前提:App.Razor 中的 <AntContainer /> 与 AddAntDesign() 服务注册;而面对"关闭后状态残留""Dispose 不触发""路由切换后确认框不销毁"等经典问题,DestroyOnClose 与 DestroyAllConfirmAsync 就是官方给出的标准答案。

登录后查看全文
ant-design-blazor