嵌套在DialogService打开的MudDialog内的内联MudDialog常显问题

问题原因 #

内联MudDialog正常渲染为模态框的前提是，能找到组件树中最近的MudDialogProvider作为渲染宿主。通过DialogService打开的对话框会被动态挂载到全局根DialogProvider下，脱离原有页面组件的渲染上下文，此时对话框内部定义的内联MudDialog找不到可用的宿主Provider，就会跳过模态渲染逻辑，直接将内容嵌入当前DOM位置，同时出现IsVisible状态控制失效、始终可见的问题。
普通页面组件中的内联对话框能正常运行，是因为项目的MainLayout中通常已经注册了全局MudDialogProvider，内联组件可以直接匹配到该宿主完成渲染。

可行解决方案 #

方案1：开启内联对话框的Portal传送（推荐） #

给内层的内联MudDialog开启Portal能力，让它直接将内容传送到全局根DialogProvider渲染，不受外层对话框的组件上下文影响，自动处理z-index层级，不需要额外添加Provider。
代码示例：

@* 该段代码为DialogService打开的外层对话框内部内容 *@
<MudButton OnClick="@(() => innerVisible = true)">打开内层对话框</MudButton>

<MudDialog @bind-IsVisible="innerVisible" 
           Portal="true" 
           Options="innerOptions">
    <DialogContent>
        <MudText>这是正常弹出的内层嵌套对话框</MudText>
    </DialogContent>
    <DialogActions>
        <MudButton OnClick="@(() => innerVisible = false)">关闭</MudButton>
    </DialogActions>
</MudDialog>

@code {
    private bool innerVisible;
    private DialogOptions innerOptions = new()
    {
        MaxWidth = MaxWidth.Small,
        FullWidth = true
    };
}

版本注意：MudBlazor 6.x 版本没有组件级Portal参数，需要在DialogOptions中配置：new DialogOptions { Portal = true }。

方案2：在外层对话框内注册专属DialogProvider #

如果不想让内层对话框挂载到全局根容器，可以在外层通过DialogService打开的组件中，单独添加一个MudDialogProvider作为当前域内所有内联对话框的渲染宿主，注意手动给内层对话框设置更高的ZIndex，避免被外层对话框的遮罩层挡住。
代码示例：

@* 外层对话框组件的最顶部添加专属Provider，不要放在DialogContent内部 *@
<MudDialogProvider />

<MudGrid>
    外层对话框原有内容
    <MudButton OnClick="@(() => innerVisible = true)">打开内层对话框</MudButton>
</MudGrid>

<MudDialog @bind-IsVisible="innerVisible" Options="innerOptions">
    <DialogContent>
        <MudText>内层对话框内容</MudText>
    </DialogContent>
</MudDialog>

@code {
    private bool innerVisible;
    private DialogOptions innerOptions = new()
    {
        ZIndex = 1300, // 外层对话框默认ZIndex为1200，内层设置更高值避免被遮挡
        MaxWidth = MaxWidth.Small,
        FullWidth = true
    };
}

注意事项 #

• 不要在外层对话框的DialogContent节点内嵌套MudDialogProvider，否则会出现遮罩层层级错乱问题，要把Provider放在外层弹出组件的最外层节点位置。
• 两种方案都不需要修改原有内联对话框的业务逻辑，只需要补充对应配置即可生效。

内容的提问来源于stack exchange，提问作者Ben5