FormCraft.ForMudBlazor 2.5.0

FormCraft.ForMudBlazor

MudBlazor UI framework implementation for FormCraft dynamic forms.

Installation

dotnet add package FormCraft.ForMudBlazor

Usage

// In Program.cs
builder.Services.AddFormCraft();
builder.Services.AddFormCraftMudBlazor();

Project Structure

The project is organized by feature, with each field type having its own folder containing both the component and renderer:

FormCraft.ForMudBlazor/
├── Extensions/
│   └── ServiceCollectionExtensions.cs    # DI registration
├── Features/
│   ├── MudBlazorUIFrameworkAdapter.cs    # Main adapter implementation
│   ├── TextField/
│   │   ├── MudBlazorTextFieldComponent.razor
│   │   └── MudBlazorTextFieldRenderer.cs
│   ├── NumericField/
│   │   ├── MudBlazorNumericFieldComponent.razor
│   │   └── MudBlazorNumericFieldRenderer.cs
│   ├── BooleanField/
│   │   ├── MudBlazorBooleanFieldComponent.razor
│   │   └── MudBlazorBooleanFieldRenderer.cs
│   ├── DateTimeField/
│   │   ├── MudBlazorDateTimeFieldComponent.razor
│   │   └── MudBlazorDateTimeFieldRenderer.cs
│   ├── SelectField/
│   │   ├── MudBlazorSelectFieldComponent.razor
│   │   └── MudBlazorSelectFieldRenderer.cs
│   ├── FileUploadField/
│   │   ├── MudBlazorFileUploadFieldComponent.razor
│   │   └── MudBlazorFileUploadFieldRenderer.cs
│   ├── CustomFields/
│   │   └── RatingRenderer.cs
│   ├── FormContainer/
│   │   ├── FormCraftComponent.razor
│   │   └── FormCraftComponent.razor.cs
│   └── Validation/
│       ├── DynamicFormValidator.cs
│       ├── FieldValidationMessage.razor
│       └── FieldValidationMessage.razor.cs

Features

• Feature-based organization: Each field type is self-contained with its component and renderer
• MudBlazor components: Uses MudBlazor's rich component library
• Type-safe rendering: Strong typing throughout the rendering pipeline
• Validation support: Integrated validation with MudBlazor's validation system
• Custom field support: Extensible architecture for custom field types

Creating Custom Fields

To add a new field type:

1. Create a new feature folder under Features/
2. Add your component (.razor file) and renderer (.cs file)
3. Register the renderer in ServiceCollectionExtensions.cs

Example:

// Features/ColorPickerField/MudBlazorColorPickerFieldRenderer.cs
public class MudBlazorColorPickerFieldRenderer : FieldRendererBase
{
    protected override Type ComponentType => typeof(MudBlazorColorPickerFieldComponent<>);
    public override bool CanRender(Type fieldType, IFieldConfiguration<object, object> field)
        => fieldType == typeof(string) && field.AdditionalAttributes.ContainsKey("color-picker");
}

// Features/ColorPickerField/MudBlazorColorPickerFieldComponent.razor
@namespace FormCraft.ForMudBlazor.Features.ColorPickerField
@typeparam TModel
@inherits FieldComponentBase<TModel, string>

<MudColorPicker T="string" 
                Label="@Label" 
                @bind-Value="@CurrentValue" 
                Required="@IsRequired"
                ReadOnly="@IsReadOnly"
                Disabled="@IsDisabled" />

Dependencies

• FormCraft (core library)
• MudBlazor (UI components)
• Microsoft.AspNetCore.Components.Web

License

This package is part of the FormCraft project and follows the same MIT license.