BlazorEnumSelect.ToreAurstadIT 1.1.0

Enum select sample

License: MIT

You can adapt this sample to your convenience. I created this component to learn more about Blazor. It is built upon sample code from user meziantou on SO and packaged and added some functionality.

Possible improvemen I would like to see in a fork:

• In case your enum contains many values, a search / filtering capability like that of select2.js could be added. (this should be possible to turn on or off)

This solution consists of a sample .NET 5.0 Blazor WASM client with Blazorise and Font Awesome added and a class library with an enum select control, i.e. a customized InputSelect control which is adapted for an enum property of a model you pass in - this custom controls supports data binding since it inherits from the InputSelect control of Blazor and just adds more functionality to it.

This package now also includes an input radio button group control for enums.

Install the package:

Install-Package BlazorEnumSelect.ToreAurstadIT

This razor class library contains a Blazor control that allows data binding to a property of type enum (nullable enums are supported).

This sample is built upon the source code presented in the article here: https://www.meziantou.net/creating-a-inputselect-component-for-enumerations-in-blazor.htm

InputSelect control

This is a select (drop down list) control for Blazor wasm that can bind to enum properties. It supports data binding and resource files for localized text. It inherits from the InputSelect control of Blazor. (so it has the same features as this control, and added customization)

In addition, this control contains some additional parameters to control the rendering output:

Parameters

Sample usage

The enum control supports data binding and is easy to use.

@page "/EnumSelect"

@using  ToreAurstadIT.BlazorEnumSelect.SampleClient.Models

<EditForm Model="@model">
    <span>Selected the some enum value: @model.SomeEnum</span>
    <ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputSelectEnum @bind-Value="@model.SomeEnum"
                                                    EmptyTextValue="-1" ShowIntValues="true" 
                                                    AdditionalCssClasses="custom-select">
    </ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputSelectEnum>
</EditForm>

@code{
    public SomeWrappingClassWithSomeEnum model = new SomeWrappingClassWithSomeEnum();
}

InputRadioGroupEnum control

This is a input radio button group control (drop down list) for Blazor wasm that can bind to enum properties. It supports data binding and resource files for localized text. It inherits from the InputRadioGroup control of Blazor. (so it has the same features as this control, and added customization)

In addition, this control contains some additional parameters to control the rendering output:

Parameters

Sample usage

The enum control supports data binding and is fairly easy to use.

@page "/EnumSelect"

@using  ToreAurstadIT.BlazorEnumSelect.SampleClient.Models

<EditForm Model="@model">
   <h5>Enum radio button group control: horizontal stacking (Requires Blazorise added)</h5>
    <em>For better visual display, add this parameter:  AdditionalCssStyleLabel="position:relative;top:-5px;" </em>
    <ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputRadioGroupEnum @bind-Value="@model.SomeEnumSecond" StackMode="StackMode.Horizontal"
                                                                     EmptyTextValue="-1" ShowIntValues="true"                                       
                                                                     AdditionalCssStyleLabel="position:relative;top:-5px;">
    </ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputRadioGroupEnum>

    <h5>Enum radio button group control - vertical stacking</h5>
        <ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputRadioGroupEnum @bind-Value="@model.SomeEnumThird" StackMode="StackMode.Vertical"
                                                                     EmptyTextValue="-1" ShowIntValues="true"                                                                  >
    </ToreAurstadIT.BlazorEnumSelect.ClassLibrary.InputRadioGroupEnum>

@code{
    public SomeWrappingClassWithSomeEnum model = new SomeWrappingClassWithSomeEnum();
}

As noted, the EmptyTextValue is set here, but not supported yet. It will be shown for now as an option in the radio button group to avoid binding issues. I.e. all enum values will be shown in this control, event the 'neutral' (None) one.

To acheve horizontal stacking, use Blazorise and the CSS class here used with the Style hack in addition. Default is vertical stacking.

Building this library into a Nuget

Run the following command after bumping Version element value

From ToreAurstadIT.BlazorEnumSelect.ClassLibrary folder :

echo Building the library and packing it. Remember to increase the version attribute value 
echo of the csproj before pushing to nuget
dotnet build  --configuration Release
dotnet pack --configuration Release

Then upload the .nupkg file from the bin\Release folder of the class library.