docs/introduce.en-US.md
Following the Ant Design specification, we developed a Blazor Components library ant-design-blazor that contains a set of high quality components and demos for building rich, interactive user interfaces.
<span>+</span>
</div> <style> .pic-plus > * { display: inline-block !important; vertical-align: middle; } .pic-plus span { font-size: 30px; color: #aaa; margin: 0 20px; } </style>WebAssembly static hosting on:
Due to WebAssembly restriction, Blazor WebAssembly doesn't support IE browser, but Blazor Server supports IE 11† with additional polyfills. See official documentation.
From .NET 5, IE 11 is no longer officially supported. See Blazor: Updated browser support. Unofficial support is provided by Blazor.Polyfill community project.
Regularly synchronize with Official Ant Design specifications, you can check the sync logs online.
Before the 1.0 release, we will only sync antd 4.x styles.
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 | 'webapp' | 'wasm' | 'server' | 'webapp' |
--styles | Whether use NodeJS and Less to compile your custom themes. | css | less | css |
--no-restore | If specified, skips the automatic restore of the project on create | bool | false |
Go to the project folder of the application and install the Nuget package reference
$ dotnet add package AntDesign
Register the services in Program.cs
builder.Services.AddAntDesign();
or Startup.cs
services.AddAntDesign();
Add namespace in _Imports.razor
@using AntDesign
To display the pop-up component dynamically, you need to add the <AntContainer /> component in App.razor.
<Routes /> for interactivity.<Routes @rendermode="RenderMode.InteractiveAuto" /> <-- specify the rendermode ✨
+ <AntContainer @rendermode="RenderMode.InteractiveAuto" /> <-- add this component ✨
<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="ButtonType.Primary">Hello World!</Button>
Click the button below to start a new workspace for development for free.
Install .NET Core SDK 9.0.100 or later.
Install Node.js (only for building style files and interoperable TypeScript files)
Clone to local development
$ git clone [email protected]:ant-design-blazor/ant-design-blazor.git
$ cd ant-design-blazor
$ npm install
$ dotnet build ./site/AntDesign.Docs.Build/AntDesign.Docs.Build.csproj
$ npm start
Visit https://localhost:5001 in your supported browser and check local development documentation for details.
Visual Studio 2022 is recommended for development.
If you would like to contribute, feel free to create a Pull Request, or give us Bug Report.
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.