Blazor 创建和使用模态对话框的方法

Blazor中可自定义实现模态对话框：通过布尔状态控制显隐、css遮罩层与z-index层级、封装为支持标题/内容/回调的Modal组件、扩展异步返回值及Esc关闭等体验优化。

Blazor 中没有内置的模态对话框（Modal）组件，但可以通过组合 html、CSS 和 Blazor 的状态管理能力轻松实现。核心思路是：用一个布尔值控制显示/隐藏，配合 backdrop 遮罩层和焦点锁定（可选），再通过事件回调传递用户操作结果。

基础模态框：用布尔状态 + CSS 实现

最简方式是定义一个 IsVisible 字段，在组件中控制其显示与隐藏，并用 inline-style 或 CSS class 控制层级和遮罩效果。

• 在 Razor 文件中添加一个 @code { bool IsVisible { get; set; } }
• 用
  包裹内容

• 添加半透明 backdrop 层（
  ），点击它关闭对话框

• 确保 modal 元素有 z-index: 1050 及以上，避免被其他组件覆盖

封装为可复用组件：Modal.razor

把模态逻辑抽成独立组件，支持传入标题、内容、按钮文字和回调函数，提升复用性。

• 新建 Components/Modal.razor，定义 [Parameter] public String Title { get; set; } = "提示"; 等参数
• 用 [Parameter] public EventCallback OnConfirm { get; set; } 和 OnCancel 暴露交互结果
• 在父组件中这样使用：确定要删除这项数据吗？
• 调用 modalRef.Show() 显示（需在 Modal.razor 中公开该方法）

进阶：支持异步操作与返回值

若需要模态框返回具体结果（如用户输入、选择项），可用 Task 配合 EventCallback。

• 在 Modal.razor 中定义 public Task ShowAsync() { ... }，内部用 TaskCompletionSource
• 点击“确认”时调用 tcs.SetResult(inputValue)，点击“取消”调用 tcs.SetResult(NULL)
• 父组件中可写：var result = await modalRef.ShowAsync(); if (result != null) { ... }

体验优化小技巧

让模态框更贴近原生应用感受，不只停留在功能可用。

• 按 Esc 键关闭：在 @onkeydown 中监听 e.Key == "Escape"，触发关闭
• 点击遮罩不关闭？加 stopPropagation 到内容区：
• 聚焦第一个可交互元素（如确认按钮）：用 ElementReference + FocusAsync() 在 OnAfterRender 中处理
• 动画过渡：用 CSS transition 或 @keyframes 配合 opacity 和 transform

基本上就这些。Blazor 模态框不复杂但容易忽略细节，关键是把状态管理清楚、交互反馈明确、样式层级正确。不需要第三方库也能做出专业体验。