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.