Migrated repository
Go to file
James Yeung 853eef8244 fix(module: table): invoke OnChange twice on pagination was changed (#1211)
* fix(module: table): invoke OnChange twice on pagination was changed

* fix preview ci
2021-03-06 10:20:41 +08:00
.config chore: add format hook (#477) 2020-08-11 05:41:46 +08:00
.github fix(module: table): invoke OnChange twice on pagination was changed (#1211) 2021-03-06 10:20:41 +08:00
.vscode rename the docs project 2021-02-06 20:15:46 +08:00
components fix(module: table): invoke OnChange twice on pagination was changed (#1211) 2021-03-06 10:20:41 +08:00
docs switch to myget feed for nightly build 2021-03-03 14:08:49 +08:00
scripts docs: add a dialog to navigate to gitee.io for chinese 2021-02-24 23:57:59 +08:00
site fix(module: table): invoke OnChange twice on pagination was changed (#1211) 2021-03-06 10:20:41 +08:00
tests feat(core): access object's property by path-based string (#1056) 2021-01-31 01:25:25 +08:00
.editorconfig feat: add simple table component (#86) 2020-05-30 01:46:41 +08:00
.gitattributes Make github main language as C# (#153) 2020-05-25 22:59:11 +08:00
.gitignore rename the docs project 2021-02-06 20:15:46 +08:00
AntDesign.sln rename the docs project 2021-02-06 20:15:46 +08:00
CHANGELOG.en-US.md changelog: 0.7.1 (#1203) 2021-03-05 08:13:20 +08:00
CHANGELOG.zh-CN.md changelog: 0.7.1 (#1203) 2021-03-05 08:13:20 +08:00
CODE_OF_CONDUCT.md docs: add guides (#414) 2020-07-23 14:44:33 +08:00
commitlint.config.js chore: add commit lint & adjust build directory 2020-03-09 18:16:44 +08:00
CONTRIBUTING.md docs: add guides (#414) 2020-07-23 14:44:33 +08:00
Directory.Build.props chore: fix SolutionDir for building (#1011) 2021-01-23 01:15:23 +08:00
LICENSE chore: prepare for 0.4.0 (#592) 2020-09-11 13:42:22 +08:00
LICENSE-ant-design.txt chore: prepare for 0.4.0 (#592) 2020-09-11 13:42:22 +08:00
logo.svg chore: add a logo and update readme 2019-12-26 15:50:38 +08:00
package.json rename the docs project 2021-02-06 20:15:46 +08:00
README-zh_CN.md switch to myget feed for nightly build 2021-03-03 14:08:49 +08:00
README.md switch to myget feed for nightly build 2021-03-03 14:08:49 +08:00

Ant Design Blazor

A set of enterprise-class UI components based on Ant Design and Blazor.

AntDesign AntDesign AntDesign.Templates codecov AntDesign Slack Group Ding Talk Group Discord Server

English | 简体中文

Features

  • 🌈 Enterprise-class UI designed for web applications.
  • 📦 A set of high-quality Blazor components out of the box.
  • 💕 Supports WebAssembly-based client-side and SignalR-based server-side UI event interaction.
  • 🎨 Supports Progressive Web Applications (PWA).
  • 🛡 Build with C#, a multi-paradigm static language for an efficient development experience.
  • ⚙️ .NET Standard 2.1/.NET 5 based, with direct reference to the rich .NET ecosystem.
  • 🎁 Seamless integration with existing ASP.NET Core MVC and Razor Pages projects.

🌈 Online Examples

WebAssembly static hosting examples:

🖥 Environment Support

  • .NET Core 3.1 / .NET 5
  • Blazor WebAssembly 3.2/.NET 5 Release
  • Supports two-way binding on the server side
  • Supports WebAssembly static file deployment
  • Support 4 major browsers engines, and Internet Explorer 11+ (Blazor Server only)
  • Run directly on Electron and other Web standards-based environments
IE / Edge
Edge / IE
Firefox
Firefox
Chrome
Chrome
Safari
Safari
Opera
Opera
Electron
Electron
Edge 16 / IE 11† 522 57 11 44 Chromium 57

Due to WebAssembly restriction, Blazor WebAssembly doesn't support IE browser, but Blazor Server supports IE 11† with additional polyfills. See official documentation

💿 Current Version

🎨 Design Specification

Regularly synchronize with Official Ant Design specifications, you can check the sync logs online.

Therefore, you can use the custom theme styles of Ant Design directly.

📦 Installation Guide

Create a new project from the dotnet new template AntDesign.Templates

We have provided the dotnet new template to create a Boilerplate project out of the box

  • Install the template

    $ dotnet new --install AntDesign.Templates
    
  • Create the Boilerplate project with the template

    $ dotnet new antdesign -o MyAntDesignApp
    

Options for the template

Options Description Type Default
-f | --full If specified, generates all pages of Ant Design Pro bool false
-ho | --host Specify the hosting model 'wasm' | 'server' | 'hosted' 'wasm'
--no-restore If specified, skips the automatic restore of the project on create bool false

Import Ant Design Blazor into an existing project

  • Go to the project folder of the application and install the Nuget package reference

    $ dotnet add package AntDesign
    
  • Register the services in Program.cs (WebAssembly)

    builder.Services.AddAntDesign();
    

    or Startup.cs (Server)

    services.AddAntDesign();
    
  • Link the static files in wwwroot/index.html (WebAssembly) or 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>
    
  • Add namespace in _Imports.razor

    @using AntDesign
    
  • To display the pop-up component dynamically, you need to add the <AntContainer /> component in App.razor.

    <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 />   <-- add this component ✨
    
  • Finally, it can be referenced in the `.razor' component!

    <Button Type="primary">Hello World!</Button>
    

⌨️ Local Development

  • Install .NET Core SDK 5.0.100 or later.

  • Install Node.js (only for building style files and interoperable TypeScript files)

  • Clone to local development

    $ git clone git@github.com:ant-design-blazor/ant-design-blazor.git
    $ cd ant-design-blazor
    $ npm install
    $ npm start
    
  • Visit https://localhost:5001 in your supported browser and check local development documentation for details.

    Visual Studio 2019 is recommended for development.

🗺 Roadmap

Check out this issue to learn about our development plans for 2020.

🤝 Contributing

PRs Welcome

If you would like to contribute, feel free to create a Pull Request, or give us Bug Report.

Contributors

This project exists thanks to all the people who contribute.

💕 Donation

This project is an MIT-licensed open source project. In order to achieve better and sustainable development of the project, we expect to gain more backers. We will use the proceeds for community operations and promotion. You can support us in any of the following ways:

We will put the detailed donation records on the backer list.

Community Support

If you encounter any problems in the process, feel free to ask for help via following channels. We also encourage experienced users to help newcomers.

  • Slack Group
  • Discord Server
Scan QR Code with DingTalk

☀️ License

AntDesign