ant-design-blazor/introduce.zh-CN.md at 781c7c09e5e0e1aa7e3cc76693ae16a1f0a9a24b

mirror of https://gitee.com/ant-design-blazor/ant-design-blazor.git synced 2024-12-02 03:57:38 +08:00

James Yeung 781c7c09e5 chore: update versions for release 0.1.0 and development of 0.2.0 (#289 )

* docs: update version 0.1.0

* chore: update versions for development of 0.2.0

2020-07-01 10:24:37 +08:00

9.0 KiB

Raw Blame History

order	title
0	Ant Design of Blazor

这里是 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 正式版
支持服务端双向绑定
支持 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†。官网说明

💿 当前版本

正式发布:
开发构建：

🎨 设计规范

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

📦 安装

先安装 .NET Core SDK 3.1.300 以上版本

创建 Blazor WebAssembly 项目

$ dotnet new blazorwasm -o MyAntDesignApp

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

$ cd MyAntDesignApp
$ dotnet add package AntDesign --version 0.1.0-*

在项目中注册:
```
services.AddAntDesign();
```

在 wwwroot/index.html(WebAssembly) 或 Pages/_Host.razor(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 3.1.300 以上版本
安装 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 ，详情参考本地开发文档。

推荐使用 Visual Studio 2019 开发。

🔗 链接

🗺 开发路线

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

🤝 如何贡献

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

❓ 社区互助

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

9.0 KiB Raw Blame History Unescape Escape