README.md

Ant Design Blazor

✨ 特性

• 提炼自企业级中后台产品的交互语言和视觉风格。
• 开箱即用的高质量 Razor 组件，可在多种托管方式共享。
• 支持基于 WebAssembly 的客户端和基于 SignalR 的服务端UI事件交互。
• 支持渐进式 Web 应用（PWA）
• 使用 C# 构建，多范式静态语言带来高效的开发体验。
• 基于 .NET Standard 2.1，可直接引用丰富的 .NET 类库。
• 可与已有的 ASP.NET Core MVC、Razor Pages 项目无缝集成。

🌈 在线示例

由 WebAssembly 构建，托管在 Gitee Pages http://ant-design-blazor.gitee.io/

🖥 支持环境

• .NET Core 3.1
• Blazor WebAssembly 3.2 preievew2
• 支持服务端双向绑定
• 支持 WebAssembly 静态文件部署
• 主流4款现代浏览器，以及 Internet Explorer 11+ （使用 Blazor Server）
• 可直接运行在 Electron 等基于 Web 标准的环境上

Edge / IE
Firefox
Chrome
Safari
Opera
Electron Edge 16 / IE 11† 522 57 11 44 Chromium 57

由于 WebAssembly 的缘故，Blazor WebAssembly 不支持 IE 浏览器，但 Blazor Server 支持 IE 11†。 官网说明

💿 当前版本

• 开发构建：

• 0.1.0：基本实现组件后发布

🎨 设计规范

与 Ant Design 设计规范定期同步，你可以在线查看同步日志。

📦 安装

• 先安装 .NET Core SDK 3.1.102 以上版本
• 安装 Blazor WebAssembly 模板

  $ dotnet new -i Microsoft.AspNetCore.Components.WebAssembly.Templates::3.2.0-preview2.20160.5
  

• 创建 Blazor WebAssembly 项目

  $ dotnet new blazorwasm -o MyAntBlazorApp
  

• 进入应用的项目文件夹，安装 Nuget 包引用

  $ cd MyAntBlazorApp
  $ dotnet add package AntBlazor --version 0.0.1-nightly-55111624

• 在项目中注册:

  services.AddAntBlazor();
  

• 在 wwwroot/index.html(WebAssembly) 或 Pages/_Host.razor(Server) 中引入静态文件:

    <link href="_content/AntBlazor/css/ant-design-blazor.css" rel="stylesheet">
    <script src="_content/AntBlazor/js/ant-design-blazor.js"></script>
  

• 在 _Imports.razor 中加入命名空间

  @using AntBlazor
  

• 最后就可以在.razor组件中引用啦！

  <AntButton type="primary">Hello World!</AntButton>
  

🔨 本地开发

• 先安装 .NET Core SDK 3.1.102 以上版本

• 安装 Node.js（只用于样式文件和互操作所需 TS 文件的构建）

• 克隆到本地开发

  $ git clone [email protected]:ElderJames/ant-design-blazor.git
  $ cd ant-design-blazor
  $ npm install
  $ npm start
  

  打开浏览器访问 https://localhost:5001 ，详情参考本地开发文档。

  推荐使用 Visual Studio 2019 开发，目前需运行 AntBlazor.Docs.ClientApp 项目才能进行断点调试。

🔗 链接

• 文档主页
• Blazor 官方文档

🗺 开发路线

查看 这个 issue 来了解我们 2020 年的开发计划。

🤝 如何贡献

如果你希望参与贡献，欢迎 Pull Request，或给我们 报告 Bug 。

❓ 社区互助

如果您在使用的过程中碰到问题，可以通过 钉钉群 寻求帮助，同时我们也鼓励资深用户通过下面的途径给新人提供帮助。

☀️ 授权协议