🌈A set of enterprise-class UI components based on Ant Design and Blazor WebAssembly.
MIT License
一套基于 Ant Design 和 Blazor 的企业级组件库
English | 简体中文
WebAssembly 静态托管页面示例
由于 WebAssembly 的限制,Blazor WebAssembly 不支持 IE 浏览器,但 Blazor Server 支持 IE 11†。 详见官网说明。
从 .NET 5 开始,Blazor 不再官方支持 IE 11。详见 Blazor: Updated browser support。社区项目 Blazor.Polyfill 提供了非官方支持。
正式发布:
每日构建:
与 Ant Design 设计规范定期同步,你可以在线查看同步日志。
因此,你可以直接使用在 Ant Design 中的自定义主题样式。
在 1.0 版本发布之前,我们将只同步 antd 4.x 的样式。
我们提供了 dotnet new
模板来创建一个开箱即用的 Ant Design Pro 新项目:
安装模板
$ dotnet new --install AntDesign.Templates
从模板创建 Ant Design Blazor Pro 项目
$ dotnet new antdesign -o MyAntDesignApp
模板的参数:
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
-f | --full
|
如果设置这个参数,会生成所有 Ant Design Pro 页面 | bool | false |
-ho | --host
|
指定托管模型 | 'webapp' | 'wasm' | 'server' | 'webapp' |
--styles |
指定样式构建类型 |
css | less
|
css |
--no-restore |
如果设置这个参数,就不会自动恢复包引用 | bool | false |
进入应用的项目文件夹,安装 Nuget 包引用
$ dotnet add package AntDesign
在项目的 Program.cs
中注册相关服务:
builder.Services.AddAntDesign();
或者在 Startup.cs
中:
services.AddAntDesign();
在 _Imports.razor
中加入命名空间
@using AntDesign
适当的位置引入 CSS 和 JS 文件。WebApp 项目在App.razor 中引入,WebAssembly 项目在 index.html 中引入
<link href="_content/AntDesign/css/ant-design-blazor.css" rel="stylesheet">
< src="_content/AntDesign/js/ant-design-blazor.js"></ script>
为了动态地显示弹出组件,需要在 App.razor
中添加一个 <AntContainer />
组件。
Routes
指定渲染模式来支持交互性。<Routes @rendermode="RenderMode.InteractiveAuto" /> <-- 指定渲染模式 ✨
+ <AntContainer @rendermode="RenderMode.InteractiveAuto" /> <-- 在这里添加容器 ✨
<Router AppAssembly="@typeof(MainLayout).Assembly">
<Found Context="routeData">
<RouteView RouteData="routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<Result Status="404" />
</LayoutView>
</NotFound>
</Router>
+ <AntContainer /> <-- 在这里添加容器 ✨
最后就可以在.razor
组件中引用啦!
<Button Type="primary">Hello World!</Button>
点击下方按钮,免费创建一个新的工作区用于开发。
先安装 .NET Core SDK 8.0.100 以上版本
安装 Node.js(只用于样式文件和互操作所需 TS 文件的构建)
克隆到本地开发
$ git clone [email protected]:ant-design-blazor/ant-design-blazor.git
$ cd ant-design-blazor
$ npm install
$ dotnet build ./site/AntDesign.Docs.Build/AntDesign.Docs.Build.csproj
$ npm start
打开浏览器访问 https://localhost:5001 ,详情参考本地开发文档。
推荐使用 Visual Studio 2022 开发。
查看这个 issue 来了解我们在 1.0 版本的开发计划。
另外也可以关注这个 issue 了解我们关于将来对 antd 5.0 适配的讨论和最新进展。
如果你希望参与贡献,欢迎 Pull Request,或给我们 报告 Bug 。
本项目以 MIT 协议开源,为了能得到够更好的且可持续的发展,我们期望获得更多的支持者,我们将把所得款项用于社区活动和推广。你可以通过如下任何一种方式支持我们:
我们会把详细的捐赠记录登记在 捐赠者名单。
如果您在使用的过程中碰到问题,可以通过以下途径寻求帮助,同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
(英文)
(中文)
另外,我还创立了面向中文开发者的 Blazor 中文社区,高手如云,只讨论技术,无卖课广告。可以加我微信(JamesYeungMVP)拉进微信群,另外也有一个 QQ 群 1012762441。广告勿扰。
感谢所有为本项目做出过贡献的朋友。
本项目采用了《贡献者公约》所定义的行为准则,以明确我们社区的预期行为。 更多信息请见 .NET Foundation Code of Conduct.
本项目由 .NET Foundation 支持。