Ant Design of Blazor 快速上手指南

Ant Design of Blazor 是基于 Ant Design 规范、适配 Blazor Server/WASM 的 UI 组件库;需通过 NuGet 安装、Program.cs 注册服务、引入 CSS 样式,并在 Razor 页面中使用 @using AntDesign 和 等组件快速开发。

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 风格,支持主题、大小、加载态等扩展属性

基本上就这些。后续可按需探索主题定制、国际化、表单联动或表格分页等高级能力——底层逻辑一致,只是组合更丰富。