Bootstrap Blazor enterprise-level UI component library

服务器端 Blazor 安装教程

环境准备

确保系统安装

visual studio 2019 或者 visual studio 2022
net5 或者 net6

BootstrapBlazor 目前支持 net5/net6

使用 BootstrapBlazor Project Template 扩展创建项目

您可以通过 [传送门] 下载安装扩展后，通过扩展创建项目

使用 Visual Studio 创建项目

步骤一、创建项目

1. 打开 Visual Studio 2019 或者 Visual Studio 2022

2. 创建一个新项目

3. 选择 Blazor App 并单击 下一步, 为项目选择一个名称和位置，然后点击 Create

4. 选择 Blazor Server App 项目类型，然后点击 Create

步骤二、将 BootstrapBlazor 组件添加到现有项目

1. 通过 nuget.org 源搜索 BootstrapBlazor

右键点击解决方案中的项目并选择 Manage Nuget Packages

dotnet add package BootstrapBlazor --version 6.2.8

2. 安装 BootstrapBlazor 包

3. 添加样式表文件

在宿主文件中增加主题样式表

~/Pages/_Host.cshtml .NET5
~/Pages/_Layout.cshtml .NET6

Tips

After this set of components version 5.0.32 remove the built-in font-awesome icon, please download it yourself or use the CDN acceleration service

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' />

<head>
    ...
    <!-- 增加代码 !-->
    <link href="https://cdn.bootcdn.net/ajax/libs/font-awesome/4.7.0/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. 添加 Javascript 文件

~/Pages/_Host.cshtml .NET5
~/Pages/_Layout.cshtml .NET6

<body>
    ...
    <!-- 增加代码 !-->
    <script src="_content/BootstrapBlazor/js/bootstrap.blazor.bundle.min.js"></script>
    ...
    <script src="_framework/blazor.server.js"></script>
</body>

5. 注册 BootstrapBlazor 服务

Starup.cs .NET5
Program.cs .NET6

Startup.cs

namespace MyBlazorAppName
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddServerSideBlazor();

            // Add this line of code
            services.AddBootstrapBlazor();
        }
    }
}

Program.cs

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddServerSideBlazor();

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

var app = builder.Build();
//more code may be present here

6. 增加命名空间引用

将以下内容添加到 ~/_Imports.razor 文件中，以便 Razor 文件中能识别组件

@using BootstrapBlazor.Components

7. 增加 BootstrapBlazorRoot 组件到 ~/App.razor 文件中

<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>正在玩命开发中 ...</p>
            </LayoutView>
        </NotFound>
    </Router>
</BootstrapBlazorRoot>

步骤三、页面中使用组件

最后一步是在页面中使用 BootstrapBlazor 组件并在浏览器中运行它。例如：

1. 在页面中增加一个 Button 按钮

<Button Color="Color.Primary" Icon="fa fa-fa" Text="测试" />

2. 在 Visual studio 2022 中 F5 运行应用程序