Ant Design Blazor Modal 模态对话框完整指南:声明式组件、ModalService 与 ConfirmService 实战
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 之前,必须完成两件基础配置(这也是文档中特别强调的前提):
-
在
App.Razor中添加<AntContainer />组件。查看 AntContainer.razor 的源码可以看到,它内部渲染了Notification、Message、ComfirmContainer、DrawerContainer、ModalContainer、ImagePreviewContainer等所有全局浮层容器,ModalService创建的对话框正是挂载到ModalContainer上的,缺少它命令式弹窗将无法渲染。 -
通过
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.InfoModalService.SuccessModalService.ErrorModalService.WarningModalService.ConfirmModalService.CreateAsyncModalService.ConfirmAsyncModalService.InfoAsyncModalService.SuccessAsyncModalService.ErrorAsyncModalService.WarningAsyncModalService.UpdateConfirmAsyncModalService.DestroyConfirmAsyncModalService.DestroyAllConfirmAsyncModalService.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)。
底层渲染机制速览
命令式弹窗之所以能"无声明而弹出",依赖的是事件驱动 + 全局容器:
ModalService.Confirm(...)等调用通过OnConfirmOpenEvent事件把ConfirmRef推给ComfirmContainer;- Confirm.razor 根据
Config.ConfirmButtons的switch分支,用BuildButton(Config.Button1Props / Button2Props / Button3Props, ...)渲染出对应数量的按钮,并分别映射到ConfirmResult.OK / Cancel / Yes / No / Retry / Abort / Ignore结果; - 用户点击按钮后,
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 体系提供了三条由浅入深的弹窗路径,可按场景自由组合:
- 声明式
<Modal>:适合"常驻在当前页面结构中的浮层",通过@bind-Visible双向绑定控制显隐,完整覆盖Draggable、Maximizable、Resizable、Centered等交互增强; ModalService命令式确认框:适合"随时随地的 OK/Cancel 确认",Confirm/Info/Success/Error/Warning返回ConfirmRef便于更新销毁,ConfirmAsync系列以Task<bool>优雅表达用户选择;ConfirmService阻塞式确认框:最接近 WinFormMessageBox,支持最多三个按钮的任意组合(OK / OKCancel / YesNo / RetryCancel / AbortRetryIgnore / YesNoCancel),直接返回ConfirmResult精确告知点击了哪个按钮。
无论走哪条路径,都不要忘记两件前提:App.Razor 中的 <AntContainer /> 与 AddAntDesign() 服务注册;而面对"关闭后状态残留""Dispose 不触发""路由切换后确认框不销毁"等经典问题,DestroyOnClose 与 DestroyAllConfirmAsync 就是官方给出的标准答案。