Blazor Server中条件包裹DOM元素避免代码冗余的方案咨询

Blazor的Razor编译器会在编译阶段校验HTML标签的闭合完整性，跨不同@if代码块的开闭标签会被识别为未闭合，因此你最初的拆分写法无法通过编译。以下是可落地的无冗余实现方案：

方案1：抽离公共内容为RenderFragment（适合单页单次使用） #

把需要重复写的公共内容封装为Razor的RenderFragment片段，仅需编写一次，两处分支直接引用即可，无冗余代码：

@{
    // 公共内容仅需定义一次
    RenderFragment CommonContent = @<text>
        <!-- 此处放置所有公共内部代码，支持任意Razor语法、自定义组件 -->
        <p>示例公共内容</p>
        <YourCustomComponent Param1="xxx" />
        <span>其他动态内容：@someVariable</span>
    </text>;
}

@if (condition)
{
    <div class="test">
        @CommonContent
    </div>
}
else
{
    @CommonContent
}

方案2：封装通用条件包裹组件（适合多场景复用） #

如果项目中多处需要类似的条件包裹逻辑，可以封装一个通用组件，使用时仅需传参即可，代码更简洁：

1. 首先创建共用组件ConditionalWrapper.razor：

@if (ShouldWrap)
{
    <Tag class="@Class" @attributes="@AdditionalAttributes">
        @ChildContent
    </Tag>
}
else
{
    @ChildContent
}

@code {
    /// <summary>
    /// 是否需要包裹外层标签
    /// </summary>
    [Parameter, EditorRequired]
    public bool ShouldWrap { get; set; }

    /// <summary>
    /// 外层包裹的标签名，默认div
    /// </summary>
    [Parameter]
    public string Tag { get; set; } = "div";

    /// <summary>
    /// 外层标签的class属性
    /// </summary>
    [Parameter]
    public string? Class { get; set; }

    /// <summary>
    /// 内部包裹的内容
    /// </summary>
    [Parameter]
    public RenderFragment? ChildContent { get; set; }

    /// <summary>
    /// 捕获其他所有传入的属性，自动绑定到外层包裹标签
    /// </summary>
    [Parameter(CaptureUnmatchedValues = true)]
    public Dictionary<string, object>? AdditionalAttributes { get; set; }
}

2. 业务页面直接调用：

<ConditionalWrapper ShouldWrap="condition" Class="test">
    <!-- 此处直接放置所有公共内部代码，仅需编写一次 -->
    <p>示例公共内容</p>
    <YourCustomComponent Param1="xxx" />
    <span>其他动态内容：@someVariable</span>
</ConditionalWrapper>

该组件支持自定义包裹标签（例如需要包裹为span只需加Tag="span"参数）、支持传入任意自定义属性，复用性极强。

临时备选方案（不推荐） #

如果只是临时快速调试，可以用MarkupString绕开编译器的标签校验，但是注意如果标签属性包含用户输入内容，必须提前做转义避免XSS风险：

@if (condition)
{
    @((MarkupString)"<div class='test'>")
}
<!-- 公共内容 -->
@if (condition)
{
    @((MarkupString)"</div>")
}

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