BlazorComponents

Useful blazor components

Installation

You can install package from nuget

<PackageReference Include="CrahunBlazorComponents" Version="2.3.5" />

Add bootstrap 4 Css

This library relies on bootstrap 4 so if need it you can link it from the library

<link href="_content/CrahunBlazorComponents/bootstrap/bootstrap.min.css" rel="stylesheet" />

Add global import in _Imports.razor

@using CrahunComponents

Skeleton table component

<SkeletonTable NumberOfColumns="4" IsLoading="isLoading" ShouldAnimate="true">
    <ChildContent>
        <tr>
            <td>
                Value1
            </td>
            <td>
                Value2
            </td>
        </tr>
    </ChildContent>
    <Head>
        <tr>
            <th>
                Column1
            </th>
            <th>
                Column2
            </th>
        </tr>
    </Head>
</SkeletonTable>

Skeleton cards

<SkeletonCards IsLoading="isLoading" ShouldAnimate="true">
    <div class="col-sm-4">
        <div class="card">
            <div class="card-header" data-simplebar>
                <h3 class="card-title">Title</h3>
            </div>
            <div class="card-body" data-simplebar>
                This is the body
            </div>
            <div class="card-footer text-right">
                This is the footer
            </div>
        </div>
    </div>
</SkeletonCards>

Wizard Component

The wizard component Will show steps in certain order. Steps can contains any other components, html or whatever you want. This component is based on creative Tim jquery wizard.

Usage

<Wizard Title="Wizard" Theme="Theme.Orange">
    <Step Name="Step 1">
        <div>Hi step 1</div>
    </Step>
    <Step Name="Step 2">
        <div>Hi step 2</div>
    </Step>
    <Step>
        <table>
            <thead>
                <tr>
                    <th>Id</th>
                    <th>Name</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td>1</td>
                    <td>Name</td>
                </tr>
            </tbody>
        </table>
    </Step>
    <Step Name="Step 3">
        <div>Adios paso 4</div>
    </Step>
    <Step>
        <div>Hi step 3</div>
    </Step>
</Wizard>

Available parameters and customizations

First you can customize the wizard colors with de Theme enum

public enum Theme
{
    Purple,
    Green,
    Blue,
    Orange,
    Red
}

You can customize the buttons meaning and color with the Buttons enum

public enum Buttons
{
    Default,
    Simple,
    Primary,
    Info,
    Success,
    Warning,
    Danger
}

Callback events on buttons/tabs

[Parameter]
public EventCallback OnPrevious { get; set; }

[Parameter]
public EventCallback OnNext { get; set; }

[Parameter]
public EventCallback OnFinished { get; set; }

[Parameter]
public EventCallback<int> OnSelectedStep { get; set; }

Buttons appearence customization

[Parameter]
public Buttons PreviousButtonClass { get; set; } = Buttons.Default;

[Parameter]
public Buttons NextButtonClass { get; set; } = Buttons.Danger;

[Parameter]
public Buttons FinishButtonClass { get; set; } = Buttons.Danger;

[Parameter]
public string NextButtonText { get; set; } = "Next";

[Parameter]
public string PreviousButtonText { get; set; } = "Previous";

[Parameter]
public string FinishedButtonText { get; set; } = "Finished";

Available public methods

IsFirstStep()
IsLastStep()
SetActivePage(int currentIndex)
NextPage()
PreviousPage()

LazyImageComponent

This component will show any image with transitions when it's fully loaded. When it's loading it will show an skeleton ui or whaterever you like.

Usage

<LazyImage ImageUrl="@($"{configuration["Urls:AuthServer"]}/images/Uploaded/{Category.PhotoUrl}")"
                           Alternative="@Category.Name" AdditionalClasses="img-responsive">
</LazyImage>

Available parameters and customizations

You can customize the image itself with the following params

[Parameter]
public string ImageUrl { get; set; }

[Parameter]
public string Alternative { get; set; }

[Parameter]
public string AdditionalStyles { get; set; }

[Parameter]
public string AdditionalClasses { get; set; }

[Parameter]
public string ImagePlaceHolderWidth { get; set; } = "100%";
    
[Parameter]
public int ImagePlaceHolderHeight { get; set; } = 200";

[Parameter]
public RenderFragment LoadingPlaceHolder { get; set; }

The loading placeholder is just a div that will show when image is loading. By default is a skeleton-ui but can be replaced by spinner or whatever you need.

DragDropUploadFile

This component will wrap the blazor InputFile component with the ability to paste from image and drag and drop files. It supports image preview and customizations.

This component is based and adapted from Meziantou's blog. All the effort is from him.

Usage

Basic usage

<DragDropUploadFile />

Customized usage

<div class="row">
    <div class="col-10">
        <DragDropUploadFile OnFileSelectionChanged="OnChange" ShowImage="false" InformationText="Sample to upload file with custom format"/>
    </div>
    <div class="col-2">
        <img src="@src" style="max-width: 100%" />
    </div>
</div>

And the corresponding code

@code {
    string src;

    // Called when a new file is uploaded
    async Task OnChange(InputFileChangeEventArgs e)
    {
        using var stream = e.File.OpenReadStream();
        using var ms = new MemoryStream();
        await stream.CopyToAsync(ms);
        src = "data:" + e.File.ContentType + ";base64," + Convert.ToBase64String(ms.ToArray());
    }
}

Available parameters and customizations

You can customize this component with the following params

[Parameter]
public string InformationText { get; set; }

[Parameter]
public bool ShowImage { get; set; }

[Parameter]
public EventCallback<InputFileChangeEventArgs> OnChangeImage { get; set; }

InputSwitch

This component wraps boolean value inside a customizable switch intead of checkbox. It allows doble-way binding as any other blazor input component.

Usage

<EditForm Model="person">
    <InputSwitch Label="Are you adult?" @bind-Value="@person.IsAdult"></InputSwitch>
</EditForm>

Available parameters and customizations

You can customize this component itself with the following params

[Parameter]
public string Label { get; set; }

[Parameter]
public bool Value { get; set; }

[Parameter]
public EventCallback<bool> ValueChanged { get; set; }

jawadjaber / blazorcomponents Goto Github PK