Ant Design of Blazor 是一套基于 Ant Design 设计规范、专为 Blazor(Server 和 WebAssembly)打造的 UI 组件库,开箱即用、风格统一、文档完善。快速上手的核心是:正确安装、注册服务、引入样式、简单使用组件。
安装与引用
在已创建的 Blazor 项目中,通过 NuGet 安装主包:
打开包管理器控制台,运行:Install-Package AntDesign 或使用 .NET CLI:dotnet add package AntDesign 确保目标框架为 .NET 6 或更高版本(推荐 .NET 8)配置服务与中间件
在 Program.cs 中添加必要注册:
调用 builder.Services.AddAntDesign() 注册组件服务 Blazor Server 项目需在 app.UseAntDesign() 前确保 app.UseStaticFiles() 已启用 WebAssembly 项目无需 UseAntDesign,但需确保静态资源可访问引入全局样式与图标
Ant Design 的样式和图标依赖于 CSS 和字体文件:
在 wwwroot/index.html(WASM)或 Pages/_Host.cshtml(Server)的 中添加:图标支持默认开启;如需完整图标集,可额外引入 ant-design-icons(非必需,按需启用)
写一个按钮试试看
在任意 Razor 页面(如
Index.razor)中直接使用组件: 添加命名空间:@using AntDesign 写一行代码: 运行项目,按钮即刻呈现 Ant Design 风格,支持主题、大小、加载态等扩展属性
基本上就这些。后续可按需探索主题定制、国际化、表单联动或表格分页等高级能力——底层逻辑一致,只是组合更丰富。
