Bootstrap Blazor enterprise-level UI component library

Client Blazor Installation Tutorial

Environmental preparation

Make sure the system is installed

visual studio 2019 or visual studio 2022
net5 or net6

BootstrapBlazor Currently supported net5/net6

Create a project using the BootstrapBlazor Project Template extension

you can pass [portal] After downloading and installing the extension, create a project through the extension

Create a project with Visual Studio 1

Step 1. Create a project

1. Open Visual Studio 2022

2. Create a new project

3. choose Blazor App and click Next step, Choose a name and location for the project, then click Create

4. Install_wasmDescription

Step 2. Add the BootstrapBlazor component to the existing project

1. pass nuget.org source search BootstrapBlazor

Right click on the project in the solution and select Manage Nuget Packages

dotnet add package BootstrapBlazor --version 7.4.4-beta01

2. Install the BootstrapBlazor package

3. Add stylesheet file

Add a theme style sheet to the host file

wwwroot/index.html

Tips

If you use the Blazor App template to create a project, please remove the default Bootstrap style link <link rel='stylesheet' href='css/bootstrap/bootstrap.min.css' />. Install FontAwesome related resources by yourself or get the nuget package BootstrapBlazor.FontAwesome

<head>
    ...

    <!-- Need to reference BootstrapBlazor.FontAwesome package !-->
    <link href="_content/BootstrapBlazor.FontAwesome/css/font-awesome.min.css" rel="stylesheet">
    <link href="_content/BootstrapBlazor/css/bootstrap.blazor.bundle.min.css" rel="stylesheet">

    ...
    <link href="css/site.css" rel="stylesheet">
    <link href="BlazorApp1.styles.css" rel="stylesheet">
</head>

4. Add Javascript files

wwwroot/index.html

<body>
    ...
    <!-- add code !-->
    <script src="_content/BootstrapBlazor/js/bootstrap.blazor.bundle.min.js"></script>
    ...
    <script src="_framework/blazor.server.js"></script>
</body>

5. Register the BootstrapBlazor service

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// Add this line of code
builder.Services.AddBootstrapBlazor();

var host = builder.Build();

await SetCultureAsync(host);

await builder.Build().RunAsync();

static async Task SetCultureAsync(WebAssemblyHost host)
{
    // 如果 localStorage 未设置语言使用浏览器请求语言
    var jsRuntime = host.Services.GetRequiredService<IJSRuntime>();
    var cultureName = await jsRuntime.GetCulture();

    if (!string.IsNullOrEmpty(cultureName))
    {
        var culture = new CultureInfo(cultureName);

        // 注意 wasm 模式此处必须使用 DefaultThreadCurrentCulture 不可以使用 CurrentCulture
        CultureInfo.DefaultThreadCurrentCulture = culture;
        CultureInfo.DefaultThreadCurrentUICulture = culture;
    }
}

6. Add namespace reference

Add the following to ~/_Imports.razor file so that Razor Components are recognized in the file

@using BootstrapBlazor.Components

7. Increase BootstrapBlazorRoot component to ~/App.razor in file

<BootstrapBlazorRoot>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <PageTitle>Title</PageTitle>
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p> under development ...</p>
            </LayoutView>
        </NotFound>
    </Router>
</BootstrapBlazorRoot>

Step 3. Use components in the page

The last step is to use in the page BootstrapBlazor component and run it in the browser. E.g：

1. add one to the page Button button

<Button Color="Color.Primary" Icon="fa-solid fa-font-awesome" Text="test" />

2. exist Visual studio 2022 middle F5 run the application