ant-design-blazor/docs/introduce.zh-CN.md
2020-12-08 19:32:38 +08:00

11 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 5可直接引用丰富的 .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 标准的环境上
IE / Edge
Edge / IE
Firefox
Firefox
Chrome
Chrome
Safari
Safari
Opera
Opera
Electron
Electron
Edge 16 / IE 11† 522 57 11 44 Chromium 57

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

💿 当前版本

  • 正式发布: AntDesign
  • 开发构建: AntDesign

🎨 设计规范

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

📦 安装

从模板创建一个新项目

我们提供了 dotnet new 模板来创建一个开箱即用的 Ant Design Pro 新项目:

  • 安装模板

    $ dotnet new --install AntDesign.Templates::0.1.0-*
    
  • 从模板创建 Ant Design Blazor Pro 项目

    $ 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 包引用

    $ 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 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 ,详情参考本地开发文档

    推荐使用 Visual Studio 2019 开发。

🔗 链接

🗺 开发路线

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

🤝 如何贡献

PRs Welcome

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

社区互助

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

  • Slack 群 (英文)
  • 钉钉群 (中文)
点击扫描钉钉二维码

☀️ 授权协议

AntDesign