2021-04-12 18:11:57 +08:00
< h1 align = "center" > Bootstrap Blazor Component< / h1 >
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
< div align = "center" >
< h2 > A set of enterprise-class UI components based on Bootstrap and Blazor.< / h2 >
2021-12-05 09:55:40 +08:00
[](https://github.com/ArgoZhang/BootstrapBlazor/blob/main/LICENSE)
2020-11-06 13:36:32 +08:00
[](https://www.nuget.org/packages/BootstrapBlazor/)
[](https://www.nuget.org/packages/BootstrapBlazor/)
[](https://github.com/ArgoZhang/BootstrapBlazor)
2021-04-12 18:11:57 +08:00
[](https://github.com/ArgoZhang/BootstrapBlazor)
2021-12-05 09:55:40 +08:00
[](https://github.com/ArgoZhang/BootstrapBlazor/actions?query=workflow%3A%22Build+Project%22+branch%3Amain)
2021-11-30 13:44:01 +08:00
[](https://codecov.io/gh/dotnetcore/BootstrapBlazor)
2020-11-06 13:36:32 +08:00
< / div >
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
English | < a href = "README.zh-CN.md" > 中文< / a >
2021-11-30 13:44:01 +08:00
---
2020-11-06 13:36:32 +08:00
## 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 based, with direct reference to the rich .NET ecosystem.
2021-01-12 12:33:18 +08:00
- Supports NET5. (Server-Side, WASM)
2020-11-06 13:36:32 +08:00
- Seamless integration with existing ASP.NET Core MVC and Razor Pages projects.
2021-01-12 12:33:18 +08:00
## Online Examples
2020-11-18 22:23:18 +08:00
[](https://www.blazor.zone)
[](https://argozhang.github.io)
2020-11-06 13:36:32 +08:00
## Installation Guide
- Install .net core sdk [Offical website ](https://dotnet.microsoft.com/download )
2021-10-28 20:10:29 +08:00
- Install Visual Studio 2022 lastest [Offical website ](https://visualstudio.microsoft.com/vs/getting-started/ )
2020-11-06 13:36:32 +08:00
## Create a new project from the dotnet new template
1. Install the template
`dotnet new -i Bootstrap.Blazor.Templates::*`
2. Create the Boilerplate project with the template
`dotnet new bbapp`
2021-01-12 12:33:18 +08:00
## Install Bootstrap Blazor Project Template
1. Download Project Template
Microsoft Market [link ](https://marketplace.visualstudio.com/items?itemName=Longbow.BootstrapBlazorUITemplate )
2. Double Click **BootstrapBlazor.UITemplate.vsix**
2020-11-06 13:36:32 +08:00
## Import Bootstrap Blazor into an existing project
1. Go to the project folder of the application and install the Nuget package reference
`dotnet add package BootstrapBlazor`
2020-04-06 15:11:28 +08:00
2020-11-21 00:56:50 +08:00
2. **Add** the `stylesheet` `javascripts` file to your main index file - `Pages/_Host.cshtml (Server)` or `wwwroot/index.html (WebAssembly)`
2020-04-06 15:11:28 +08:00
2021-01-12 12:33:18 +08:00
**HTML**
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
```HTML
<!DOCTYPE html>
< html lang = "en" >
< head >
. . .
2020-11-20 00:03:27 +08:00
< link rel = "stylesheet" href = "_content/BootstrapBlazor/css/bootstrap.blazor.bundle.min.css" >
2020-11-06 13:36:32 +08:00
< / head >
< body >
. . .
< script src = "_framework/blazor.server.js" > < / script >
< script src = "_content/BootstrapBlazor/js/bootstrap.blazor.bundle.min.js" > < / script >
< / body >
< / html >
2021-01-12 12:33:18 +08:00
```
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
3. Open the `~/Startup.cs` file in the and register the `Bootstrap Blazor` service:
2020-04-06 15:11:28 +08:00
2021-01-12 12:33:18 +08:00
**C#**
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
```csharp
namespace BootstrapBlazorAppName
{
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
//more code may be present here
2021-01-12 12:33:18 +08:00
services.AddBootstrapBlazor();
2020-11-06 13:36:32 +08:00
}
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
//more code may be present here
}
}
```
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
## Visual Studio Integration
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
To create a new `Bootstrap Blazor` UI for Blazor application, use the Create New Project Wizard. The wizard detects all installed versions of `Bootstrap Blazor` for Blazor and lists them in the Version combobox—this enables you to start your project with the desired version. You can also get the latest version to make sure you are up to date.
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
1. Get the Wizard
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
To use the Create New Project Wizard, install the `Bootstrap Blazor` UI for Blazor Visual Studio Extensions. You can get it from the:
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
- Visual Studio Marketplace (for Windows)
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
2. Start the Wizard
To start the wizard, use either of the following approaches
### Using the Project menu:
- Click File > New > Project.
- Find and click the C# Blazor Application option (you can use the search, or filter by Blazor templates).
- Follow the wizard.
## Supported browsers
2021-01-12 12:33:18 +08:00
### Mobile devices
2020-11-06 13:36:32 +08:00
| | **Chrome** | **Firefox** | **Safari** | **Android Browser & WebView** | **Microsoft Edge** |
| ------- | --------- | --------- | ------ | ------------------------- | -------------- |
| **iOS** | Supported | Supported | Supported | N/A | Supported |
| **Android** | Supported | Supported | N/A | Android v5.0+ supported | Supported |
| **Windows 10 Mobile** | N/A | N/A | N/A | N/A | Supported |
2021-01-12 12:33:18 +08:00
### Desktop browsers
2020-11-06 13:36:32 +08:00
| | Chrome | Firefox | Internet Explorer | Microsoft Edge | Opera | Safari |
| ------- | --------- | --------- | ----------------- | -------------- | --------- | ------------- |
| Mac | Supported | Supported | N/A | N/A | Supported | Supported |
| Linux | Supported | Supported | N/A | N/A | N/A | N/A |
| Windows | Supported | Supported | Supported, IE11+ | Supported | Supported | Not supported |
## Screenshots
2020-04-06 15:11:28 +08:00
2020-12-22 00:27:05 +08:00
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
## Contribution
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
1. Fork
2. Create Feat_xxx branch
3. Commit
4. Create Pull Request
2020-04-06 15:11:28 +08:00
2020-11-06 13:36:32 +08:00
## Donate
2020-04-06 15:11:28 +08:00
2021-01-12 12:33:18 +08:00
If this project is helpful to you, please scan the QR code below for a cup of coffee.
2020-04-06 15:11:28 +08:00
2020-12-22 00:27:05 +08:00
< img src = "https://raw.githubusercontent.com/ArgoZhang/Images/master/Donate/BarCode%402x.png" width = "382px;" / >
