Blazorise DropDownItem的ShowCheckbox属性失效问题

问题说明 #

复制Blazorise官方文档中带复选框的Dropdown组件代码到项目后，菜单内未显示复选框，但官网示例中相同代码可正常展示。项目内其他Blazorise组件功能均正常。

复现代码 #

<Dropdown>
    <DropdownToggle Color="Color.Primary">
        Dropdown With Checkboxes
    </DropdownToggle>
    <DropdownMenu>
        <DropdownItem ShowCheckbox>Checkbox</DropdownItem>
        <DropdownDivider />
        <DropdownItem ShowCheckbox>Another Checkbox</DropdownItem>
        <DropdownItem ShowCheckbox Disabled>Checkbox Disabled</DropdownItem>
        <DropdownItem>Action</DropdownItem>
    </DropdownMenu>
</Dropdown>

排查及解决方向 #

• 版本兼容性问题：ShowCheckbox是Blazorise的较新特性，若你使用的NuGet包版本低于该特性的引入版本，会导致属性不生效。检查项目中Blazorise相关包的版本，升级到与官网示例一致的稳定版。
• 样式框架集成不全：Blazorise依赖第三方样式库（如Bootstrap、Material UI等）提供组件样式，复选框的渲染需要对应样式库的支持。确认项目中已正确引入所选样式库的静态资源：
  • Blazor Server项目：在_Host.cshtml中检查是否添加了样式库的CSS和必要JS文件引用
  • Blazor WebAssembly项目：在index.html中完成相同的资源引用配置
• 服务注册不完整：虽然其他组件正常，但需确认启动配置（Program.cs）中已完整注册Blazorise服务及对应扩展。例如使用Bootstrap样式的配置示例：

builder.Services.AddBlazorise(options =>
{
    options.Immediate = true;
})
.AddBootstrapProviders()
.AddFontAwesomeIcons();

• 编译缓存干扰：清理项目的bin和obj目录，重新编译并重启应用，排除旧编译缓存导致的功能异常。

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