Bootstrap Blazor enterprise-level UI component library

Enterprise-level component library based on Bootstrap and Blazor

Example Razor C#Video

Block

Depending on the parameter conditions, the contents of the block are determined to be displayed, usually in conjunction with permission authorization

Common usage

Determines whether component content is displayed by setting the OnQueryCondition callback method return value

Demo

I am component content

@inject IStringLocalizer<BlockNormal> Localizer

<div class="mb-3" style="height: 21px;">
    <Block OnQueryCondition="OnQueryCondition" Name="Normal">
        <div>@Localizer["Content"]</div>
    </Block>
</div>
<Button Icon="@GetIcon()" Text="@GetText()" OnClick="ToggleCondition" />

@code {
    private bool IsShow { get; set; } = true;
    private string GetIcon() => IsShow ? "fa-solid fa-eye-slash" : "fa-solid fa-eye";
    private string GetText() => IsShow ? Localizer["IsHide"] : Localizer["IsShow"];
    private void ToggleCondition() => IsShow = !IsShow;
    private Task<bool> OnQueryCondition(string name) => Task.FromResult(IsShow);
}

Template

By setting authorized NotAuthorized you can set what appears when you meet and do not meet the criteria, respectively

Demo

I am the component content that displayed in accordancewith the criteria

@inject IStringLocalizer<BlockTemplate> Localizer
<div class="mb-3" style="height: 21px;">
    <Block OnQueryCondition="OnQueryCondition2" Name="Template">
        <Authorized>
            <div>@((MarkupString)Localizer["TemplateDiv1"].Value)</div>
        </Authorized>
        <NotAuthorized>
            <div>@((MarkupString)Localizer["TemplateDiv2"].Value)</div>
        </NotAuthorized>
    </Block>
</div>
<Button Icon="@GetIcon2()" Text="@GetText2()" OnClick="ToggleCondition2" />

@code {
    private bool IsShow2 { get; set; } = true;

    private void ToggleCondition2() => IsShow2 = !IsShow2;

    private string GetIcon2() => IsShow2 ? "fa-solid fa-eye-slash" : "fa-solid fa-eye";

    private string GetText2() => IsShow2 ? Localizer["IsHide"] : Localizer["IsShow"];

    private Task<bool> OnQueryCondition2(string name) => Task.FromResult(IsShow2);
}

Judging by permissions

This example simulates a user logging in to control whether the content Block is displayed, which is easier to use than AuthorizeView

Demo

I am the contents of the AuthorizeView component and are not currently logged in

@using Microsoft.AspNetCore.Components.Authorization
@inject IStringLocalizer<BlockAuthorizate> Localizer

<div class="mb-3" style="height: 21px;">
    <Block OnQueryCondition="OnQueryUser" Name="Authorized">
        <div>@((MarkupString)Localizer["AuthorizateDiv1", UserName].Value)</div>
    </Block>
</div>
<Microsoft.AspNetCore.Components.Authorization.CascadingAuthenticationState>
    <Microsoft.AspNetCore.Components.Authorization.AuthorizeView>
        <Authorized>
            <div>@((MarkupString)Localizer["AuthorizateDiv2", context.User.Identity?.Name!].Value)</div>
        </Authorized>
        <NotAuthorized>
            <div>@((MarkupString)Localizer["AuthorizateDiv3"].Value)</div>
        </NotAuthorized>
    </Microsoft.AspNetCore.Components.Authorization.AuthorizeView>
</Microsoft.AspNetCore.Components.Authorization.CascadingAuthenticationState>
<Button Icon="@GetUser()" Text="@GetUserText()" OnClick="ToggleAuthor" class="mt-3" />

@code {
    [Inject]
    [NotNull]
    private AuthenticationStateProvider? AuthenticationStateProvider { get; set; }

    private bool IsAuth { get; set; }

    [NotNull]
    private string? UserName { get; set; }

    private async Task ToggleAuthor()
    {
        if (AuthenticationStateProvider is MockAuthenticationStateProvider mock)
        {
            if (!IsAuth)
            {
                mock.Login();
                var state = await mock.GetAuthenticationStateAsync();
                UserName = state.User.Identity?.Name;
                IsAuth = state.User.Identity?.IsAuthenticated ?? false;
            }
            else
            {
                mock.Logout();
                IsAuth = false;
                UserName = "";
            }
        }
    }

    private IEnumerable<string> Users { get; } = new string[] { "BootstrapBlazor" };

    private IEnumerable<string> Roles { get; } = new string[] { "User" };

    private string GetUser() => IsAuth ? "fa-solid fa-user-secret" : "fa-solid fa-user";

    private string GetUserText() => IsAuth ? Localizer["Logout"] : Localizer["Login"];

    private Task<bool> OnQueryUser(string name) => Task.FromResult(IsAuth);
}

Pre-set the user

By setting Users controls the display, which is displayed when the currently logged-in user is a preset user

Demo

@using Microsoft.AspNetCore.Components.Authorization
@inject IStringLocalizer<BlockUsers> Localizer
<div style="height: 21px;">
    <Block Users="@Users">
        <div>@((MarkupString)Localizer["UsersDiv1", UserName].Value)</div>
    </Block>
</div>
<Button Icon="@GetUser()" Text="@GetUserText()" OnClick="ToggleAuthor" class="mt-3" />

@code {
    [Inject]
    [NotNull]
    private AuthenticationStateProvider? AuthenticationStateProvider { get; set; }

    private bool IsAuth { get; set; }

    private IEnumerable<string> Users { get; } = new string[] { "BootstrapBlazor" };

    [NotNull]
    private string? UserName { get; set; }
    private string GetUser() => IsAuth ? "fa-solid fa-user-secret" : "fa-solid fa-user";
    private string GetUserText() => IsAuth ? Localizer["Logout"] : Localizer["Login"];
    private async Task ToggleAuthor()
    {
        if (AuthenticationStateProvider is MockAuthenticationStateProvider mock)
        {
            if (!IsAuth)
            {
                mock.Login();
                var state = await mock.GetAuthenticationStateAsync();
                UserName = state.User.Identity?.Name;
                IsAuth = state.User.Identity?.IsAuthenticated ?? false;
            }
            else
            {
                mock.Logout();
                IsAuth = false;
                UserName = "";
            }
        }
    }
}

Preset roles

By setting Roles controls the display, which is displayed when the currently logged-in user is in a preset role

Demo

@using Microsoft.AspNetCore.Components.Authorization
@inject IStringLocalizer<BlockRoles> Localizer
<div style="height: 21px;">
    <Block Roles="@Roles">
        <div>@((MarkupString)Localizer["RolesDiv1"].Value)</div>
    </Block>
</div>
<Button Icon="@GetUser()" Text="@GetUserText()" OnClick="ToggleAuthor" class="mt-3" />

@code {
    private string GetUser() => IsAuth ? "fa-solid fa-user-secret" : "fa-solid fa-user";
    [Inject]
    [NotNull]
    private AuthenticationStateProvider? AuthenticationStateProvider { get; set; }
    private IEnumerable<string> Roles { get; } = new string[] { "User" };
    private bool IsAuth { get; set; }

    [NotNull]
    private string? UserName { get; set; }
    private string GetUserText() => IsAuth ? Localizer["Logout"] : Localizer["Login"];
    private async Task ToggleAuthor()
    {
        if (AuthenticationStateProvider is MockAuthenticationStateProvider mock)
        {
            if (!IsAuth)
            {
                mock.Login();
                var state = await mock.GetAuthenticationStateAsync();
                UserName = state.User.Identity?.Name;
                IsAuth = state.User.Identity?.IsAuthenticated ?? false;
            }
            else
            {
                mock.Logout();
                IsAuth = false;
                UserName = "";
            }
        }
    }
}

Tips

By setting different Name as a resource, combined with the authorization system to authorize this resource can be achieved to any element of the Web page permission control

Attributes

@page "/blocks"
@inject IStringLocalizer<Blocks> Localizer

<h3>Block</h3>

<h4>Depending on the parameter conditions, the contents of the block are determined to be displayed, usually in conjunction with permission authorization</h4>

<DemoBlock Title="Common usage" Introduction="Determines whether component content is displayed by setting the <code>OnQueryCondition</code> callback method return value" Name="Normal" Demo="typeof(Demos.Block.BlockNormal)" />

<DemoBlock Title="Template" Introduction="By setting <code>authorized</code> <code>NotAuthorized</code> you can set what appears when you meet and do not meet the criteria, respectively" Name="Template" Demo="typeof(Demos.Block.BlockTemplate)" />

<DemoBlock Title="Judging by permissions" Introduction="This example simulates a user logging in to control whether the content <code>Block</code> is displayed, which is easier to use than <code>AuthorizeView</code>" Name="Authorizate" Demo="typeof(Demos.Block.BlockAuthorizate)" />

<DemoBlock Title="Pre-set the user" Introduction="By setting <code>Users</code> controls the display, which is displayed when the currently logged-in user is a preset user" Name="Users" Demo="typeof(Demos.Block.BlockUsers)" />

<DemoBlock Title="Preset roles" Introduction="By setting <code>Roles</code> controls the display, which is displayed when the currently logged-in user is in a preset role" Name="Roles" Demo="typeof(Demos.Block.BlockRoles)" />

<Tips class="mt-3">
    <p>By setting different <code>Name</code> as a resource, combined with the authorization system to authorize this resource can be achieved to any element of the Web page permission control</p>
</Tips>

<AttributeTable Items="@GetAttributes()" />

// Copyright (c) Argo Zhang (argo@163.com). All rights reserved.
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
// Website: https://www.blazor.zone or https://argozhang.github.io/

using BootstrapBlazor.Shared.Services;
using Microsoft.AspNetCore.Components.Authorization;

namespace BootstrapBlazor.Shared.Samples;

/// <summary>
/// 
/// </summary>
public partial class Blocks
{

    private IEnumerable<AttributeItem> GetAttributes() => new AttributeItem[]
    {
        new AttributeItem()
        {
            Name = nameof(Block.OnQueryCondition),
            Description = Localizer["OnQueryCondition"],
            Type = "Func<Task<bool>>",
            ValueList = " — ",
            DefaultValue = "true"
        },
        new AttributeItem()
        {
            Name = nameof(Block.ChildContent),
            Description = Localizer["ChildContent"],
            Type = "RenderFragment",
            ValueList = " — ",
            DefaultValue = " — "
        },
        new AttributeItem()
        {
            Name = nameof(Block.Authorized),
            Description = Localizer["Authorized"],
            Type = "RenderFragment",
            ValueList = " — ",
            DefaultValue = " — "
        },
        new AttributeItem()
        {
            Name = nameof(Block.NotAuthorized),
            Description = Localizer["NotAuthorized"],
            Type = "RenderFragment",
            ValueList = " — ",
            DefaultValue = " — "
        }
    };
}

Block

Depending on the parameter conditions, the contents of the block are determined to be displayed, usually in conjunction with permission authorization

Demo

Demo

Demo

Demo

Demo

Tips

Attributes

Bootstrap Blazor Component library updated to 7.2.5-beta02