mirror of
https://gitee.com/ant-design-blazor/ant-design-blazor.git
synced 2024-12-04 13:08:23 +08:00
192 lines
12 KiB
Markdown
192 lines
12 KiB
Markdown
---
|
||
order: 0
|
||
title: Ant Design of Blazor
|
||
---
|
||
|
||
这里是 Ant Design 的 Blazor 实现，开发和服务于企业级后台产品。
|
||
|
||
<div class="pic-plus">
|
||
<img width="150" src="https://gw.alipayobjects.com/zos/rmsportal/KDpgvguMpGfqaHPjicRK.svg">
|
||
<span>+</span>
|
||
<img height="150" src="https://raw.githubusercontent.com/ant-design-blazor/ant-design-blazor/master/docs/assets/blazor.svg">
|
||
</div>
|
||
|
||
<style>
|
||
.pic-plus > * {
|
||
display: inline-block !important;
|
||
vertical-align: middle;
|
||
}
|
||
.pic-plus span {
|
||
font-size: 30px;
|
||
color: #aaa;
|
||
margin: 0 20px;
|
||
}
|
||
</style>
|
||
|
||
## ✨ 特性
|
||
|
||
- 🌈 提炼自企业级中后台产品的交互语言和视觉风格。
|
||
- 📦 开箱即用的高质量 Razor 组件，可在多种托管方式共享。
|
||
- 💕 支持基于 WebAssembly 的客户端和基于 SignalR 的服务端 UI 事件交互。
|
||
- 🎨 支持渐进式 Web 应用（PWA）
|
||
- 🛡 使用 C# 构建，多范式静态语言带来高效的开发体验。
|
||
- ⚙️ 基于 .NET Standard 2.1/.NET 5/.NET 6，可直接引用丰富的 .NET 类库。
|
||
- 🎁 可与已有的 ASP.NET Core MVC、Razor Pages 项目无缝集成。
|
||
- 💴 基于 MIT 开源协议，.NET 基金会项目，商业应用免费。
|
||
|
||
## 🌈 在线示例
|
||
|
||
由 WebAssembly 构建，托管在 Azure Static WebApp https://antblazor.com/
|
||
|
||
## 🖥 支持环境
|
||
|
||
- 兼容 .NET Core 3.1 / .NET 5 / .NET 6
|
||
- 最新支持 Blazor WebAssembly 6.0 正式版
|
||
- 支持服务端双向绑定
|
||
- 支持 WebAssembly 静态文件部署
|
||
- 主流 4 款现代浏览器，以及 Internet Explorer 11+ （使用 [Blazor Server](https://docs.microsoft.com/zh-cn/aspnet/core/blazor/supported-platforms?view=aspnetcore-6.0&WT.mc_id=DT-MVP-5003987)）
|
||
- 可直接运行在 [.NET MAUI](https://dotnet.microsoft.com/zh-cn/apps/maui?WT.mc_id=DT-MVP-5003987)、[WPF](https://docs.microsoft.com/en-us/aspnet/core/blazor/hybrid/tutorials/wpf?view=aspnetcore-6.0&WT.mc_id=DT-MVP-5003987)、[Windows Forms](https://docs.microsoft.com/en-us/aspnet/core/blazor/hybrid/tutorials/windows-forms?view=aspnetcore-6.0) 等 Blazor 混合客户端环境中。
|
||
- 可直接运行在 [Electron](http://electron.atom.io/) 等基于 Web 标准的环境上
|
||
|
||
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br> Edge / IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/electron/electron_48x48.png" alt="Electron" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Electron |
|
||
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||
| Edge 16 / IE 11† | 522 | 57 | 11 | 44 | Chromium 57 |
|
||
|
||
> 由于 [WebAssembly](https://webassembly.org) 的缘故，Blazor WebAssembly 不支持 IE 浏览器，但 Blazor Server 支持 IE 11†。 详见[官网说明](https://docs.microsoft.com/en-us/aspnet/core/blazor/supported-platforms?view=aspnetcore-3.1&WT.mc_id=DT-MVP-5003987)。
|
||
|
||
> 从 .NET 5 开始，Blazor 不再官方支持 IE 11。详见 [Blazor: Updated browser support](https://docs.microsoft.com/en-us/dotnet/core/compatibility/aspnet-core/5.0/blazor-browser-support-updated)。社区项目 [Blazor.Polyfill](https://github.com/Daddoon/Blazor.Polyfill) 提供了非官方支持。
|
||
|
||
## 💿 当前版本
|
||
|
||
- 正式发布: [](https://www.nuget.org/packages/AntDesign/)
|
||
- 开发构建： [](https://www.nuget.org/packages/AntDesign/)
|
||
|
||
## 🎨 设计规范
|
||
|
||
与 Ant Design 设计规范定期同步，你可以在线查看[同步日志](https://github.com/ant-design-blazor/ant-design-blazor/actions?query=workflow%3A%22Style+sync+Bot%22)。
|
||
|
||
## 📦 安装
|
||
|
||
- 先安装 [.NET Core SDK](https://dotnet.microsoft.com/download/dotnet-core/3.1?WT.mc_id=DT-MVP-5003987) 3.1.300 以上版本
|
||
|
||
### 从模板创建一个新项目
|
||
|
||
我们提供了 `dotnet new` 模板来创建一个开箱即用的 [Ant Design Pro](https://github.com/ant-design-blazor/ant-design-pro-blazor) 新项目：
|
||
|
||
- 安装模板
|
||
|
||
```bash
|
||
$ dotnet new --install AntDesign.Templates::0.1.0-*
|
||
```
|
||
|
||
- 从模板创建 Ant Design Blazor Pro 项目
|
||
|
||
```bash
|
||
$ dotnet new antdesign -o MyAntDesignApp
|
||
```
|
||
|
||
模板的参数：
|
||
|
||
| 参数 | 说明 | 类型 | 认 值 |
|
||
| ----------------- | ------------------------------------------------ | ------------------------------ | ------ |
|
||
| `-f` \| `--full` | 如果设置这个参数，会生成所有 Ant Design Pro 页面 | bool | false |
|
||
| `-ho` \| `--host` | 指定托管模型 | 'wasm' \| 'server' \| 'hosted' | 'wasm' |
|
||
| `--no-restore` | 如果设置这个参数，就不会自动恢复包引用 | bool | false |
|
||
|
||
### 在已有项目中引入 Ant Design Blazor
|
||
|
||
- 进入应用的项目文件夹，安装 Nuget 包引用
|
||
|
||
```bash
|
||
$ dotnet add package AntDesign --version 0.1.0-*
|
||
```
|
||
|
||
- 在项目中注册:
|
||
|
||
```
|
||
services.AddAntDesign();
|
||
```
|
||
|
||
- 在 `wwwroot/index.html`(WebAssembly) 或 `Pages/_Host.cshtml`(Server) 中引入静态文件:
|
||
|
||
```
|
||
<link href="_content/AntDesign/css/ant-design-blazor.css" rel="stylesheet">
|
||
<script src="_content/AntDesign/js/ant-design-blazor.js"></script>
|
||
```
|
||
|
||
- 在 `_Imports.razor` 中加入命名空间
|
||
|
||
```
|
||
@using AntDesign
|
||
```
|
||
|
||
- 为了动态地显示弹出组件，需要在 `App.razor` 中添加一个 `<AntContainer />` 组件。
|
||
|
||
```
|
||
<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](https://dotnet.microsoft.com/download/dotnet/5.0?WT.mc_id=DT-MVP-5003987) 5.0.100 以上版本
|
||
- 安装 Node.js（只用于样式文件和互操作所需 TS 文件的构建）
|
||
- 克隆到本地开发
|
||
|
||
```
|
||
$ git clone git@github.com:ant-design-blazor/ant-design-blazor.git
|
||
$ cd ant-design-blazor
|
||
$ npm install
|
||
$ npm start
|
||
```
|
||
|
||
打开浏览器访问 https://localhost:5001 ，详情参考[本地开发文档](https://github.com/ant-design-blazor/ant-design-blazor/wiki)。
|
||
|
||
> 推荐使用 Visual Studio 2019 开发。
|
||
|
||
## 🔗 链接
|
||
|
||
- [文档主页](https://ant-design-blazor.gitee.io)
|
||
- [Blazor 官方文档](https://docs.microsoft.com/zh-cn/aspnet/core/blazor/?WT.mc_id=DT-MVP-5003987)
|
||
- [MS Learn 平台 Blazor 教程](https://docs.microsoft.com/zh-cn/learn/modules/build-blazor-webassembly-visual-studio-code/?WT.mc_id=DT-MVP-5003987)
|
||
|
||
## 🗺 开发路线
|
||
|
||
查看 [这个 issue](https://github.com/ant-design-blazor/ant-design-blazor/issues/21) 来了解我们 2020 年的开发计划。
|
||
|
||
## 🤝 如何贡献
|
||
|
||
[](https://github.com/ant-design-blazor/ant-design-blazor/pulls)
|
||
|
||
如果你希望参与贡献，欢迎 [Pull Request](https://github.com/ant-design-blazor/ant-design-blazor/pulls)，或给我们 [报告 Bug](https://github.com/ant-design-blazor/ant-design-blazor/issues/new) 。
|
||
|
||
## ❓ 社区互助
|
||
|
||
如果您在使用的过程中碰到问题，可以通过以下途径寻求帮助，同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
|
||
|
||
- [](https://h5.dingtalk.com/circle/healthCheckin.html?corpId=dingf3df1949a4aa48627b0128d9a44ecb79&c5df5865-4f41-=be1b34c7-397b-&cbdbhh=qwertyuiop&origin=11) (中文)
|
||
|
||
<img src="https://raw.githubusercontent.com/ant-design-blazor/ant-design-blazor/master/docs/assets/dingtalk.jpg" width="300">
|
||
|
||
- 另外，我还创立了面向中文开发者的 Blazor 中文社区，高手如云，只讨论技术，无卖课广告。可以加我微信（JamesYeungMVP）拉进微信群，另外也有一个 QQ 群 1012762441。广告勿扰。
|
||
|
||
## ☀️ 授权协议
|
||
|
||
[](https://github.com/ant-design-blazor/ant-design-blazor/blob/master/LICENSE)
|