BenjaminBiber.DynamicInput 0.1.1

BenjaminBiber.DynamicInput

Eine kleine Razor-Class-Library, die mithilfe von MudBlazor Formulare automatisch aus beliebigen Objektinstanzen erzeugt. Die Komponente DynamicObjectEditor liest per Reflexion alle öffentlichen, schreibbaren Properties und rendert passende Eingaben (Text, Switch, Numeric, DateTime sowie Selects über Optionsattribute). Änderungen können optional gepuffert und erst über einen Submit-Button übernommen werden.

Installation

# innerhalb deines Blazor-Projekts
Dotnet add package BenjaminBiber.DynamicInput

Tipp: Achte darauf, dass dein Host-Projekt MudBlazor korrekt initialisiert (CSS/JS + MudThemeProvider, MudDialogProvider, MudPopoverProvider, MudSnackbarProvider).

Verwendung

1. Referenz auf die Bibliothek setzen (@using BenjaminBiber.DynamicInput in _Imports.razor).
2. Ein Modell übergeben, dessen öffentliche Properties automatisch editiert werden sollen.
3. DynamicObjectEditor einbinden:

<DynamicObjectEditor Model="@Person"
                      ModelChanged="OnPersonChanged"
                      RequireSubmit="true"
                      SubmitButtonText="Änderungen anwenden"
                      WrapperClass="pa-4"
                      InputClass="w-100"
                      BooleanDisplay="DynamicInputBooleanDisplay.Checkbox"
                      SubmitButtonClass="mt-4" />

Parameter

Property-Attribute

Tipp: Platziere Eigenschaften, die dieselbe Überschrift erhalten sollen, unmittelbar hintereinander – so entsteht ein sauberer Abschnitt ohne doppelte Headings.

Hinweis: BooleanDisplay="DynamicInputBooleanDisplay.Checkbox" macht Checkboxen zur Voreinstellung – einzelne Felder kannst du mit [DynamicInputBoolean(DynamicInputBooleanDisplay.Switch)] weiter als Switch darstellen.

Options-Provider

Die Optionsmethode darf die folgenden Rückgabetypen (auch als Task<>) liefern:

• IDictionary<string, object?>
• IEnumerable<KeyValuePair<string, object?>>
• IEnumerable<DynamicInputOption> oder IReadOnlyList<DynamicInputOption>

public class SamplePerson
{
    [DynamicInputOptions(nameof(GetStatusOptionsAsync))]
    public string? Status { get; set; }

    private Task<IDictionary<string, object?>> GetStatusOptionsAsync()
        => Task.FromResult<IDictionary<string, object?>>(new Dictionary<string, object?>
        {
            ["Aktiv"] = "active",
            ["Pausiert"] = "paused",
            ["Archiviert"] = "archived"
        });
}

Selects & andere Typen

DynamicObjectEditor erkennt aktuell folgende Typen und rendert passende MudBlazor-Komponenten:

• string, Guid → MudTextField
• bool → MudSwitch oder MudCheckBox (steuerbar via BooleanDisplay bzw. [DynamicInputBoolean])
• Zahlen (alle gängigen int, long, decimal, float, double inkl. Nullable) → MudNumericField; für int/int? lassen sich Min/Max + Slider über [DynamicInputInteger] festlegen
• DateTime → MudDatePicker
• Properties mit [DynamicInputOptions] → MudSelect

Nicht unterstützte Typen werden als MudAlert angezeigt, damit du sofort weißt, was noch fehlt.

Deferred Editing

Wenn RequireSubmit auf true steht, werden Änderungen zunächst in einer internen Dictionary<string, object?> gehalten. Erst der Submit-Button schreibt die Werte ins Modell und löst optional ModelChanged aus. Das erlaubt z. B. Review- oder Wizard-Szenarien.

Beispielprojekt

Im Repo befindet sich BenjaminBiber.DynamicInput.TestServer, eine Blazor-Server-App, die sämtliche Features demonstriert (Sofort- vs. Submit-Modus, [DynamicInputIgnore], [DynamicInputClass], Selects). Starte sie mit:

dotnet run --project BenjaminBiber.DynamicInput.TestServer

Roadmap / Ideen

• Eigene Templates für Layout/Labels
• Unterstützung weiterer Typen (z. B. TimeOnly, DateOnly, File Uploads)
• Validierungsausgabe über EditContext

Beiträge und Vorschläge sind willkommen!