RadioButtonList
Auswahl-Liste mit Radio-Buttons. Unterstützt beliebige Werttypen (string, int, …), vertikale und horizontale Ausrichtung, Disabled-Zustand, AfterValueChanged, AutoSaveCallback und Validierung per DataAnnotations.
Ausrichtung
Die Ausrichtung der Radio-Buttons wird über
Orientation gesteuert: Vertical (Standard) oder Horizontal.
Vertikal
Farbe
Auswahl: Grün
Horizontal
Größe
Auswahl: M
Werttypen
Die Komponente ist generisch (
TItem, TValue) – TValue kann jeder vergleichbare Typ sein, z.B. string, int? oder Enum-Werte.
string
Zahlungsmethode
Auswahl: Kreditkarte
int?
Priorität
Auswahl: 2
Zustände
Keine Vorauswahl:
Disabled: Alle Buttons sind gesperrt, der Wert ist nicht änderbar.
Value ist null – kein Button ist initial markiert.Disabled: Alle Buttons sind gesperrt, der Wert ist nicht änderbar.
Keine Vorauswahl
Sprache
Auswahl: –
Disabled
Gesperrte Auswahl
Nicht veränderbar
AfterValueChanged
AfterValueChanged wird nach jeder Wertänderung ausgelöst – unabhängig von Validierung. Nützlich für reaktive UI-Updates.
Callback zählen
Kategorie
Änderungen: 0×
AutoSaveCallback
AutoSaveCallback wird nach jeder Wertänderung ausgelöst – standardmäßig nur wenn das Feld gültig ist (TriggerAutoSaveCallbackOnlyIfValid).
AutoSave bei Änderung
Sprache
Gespeichert: –
Enum und einfache Listen
Enum:
List<string>: Elemente ohne
TValue ist ein Enum, die Value-Property der Elemente liefert den Enum-Wert.List<string>: Elemente ohne
Text/Value-Property werden selbst als Anzeige und Wert verwendet.
Enum
Versandart
Auswahl: Standard
List<string>
Anrede
Auswahl: Frau
Label, Größen und lange Texte
Label erscheint als Gruppenbeschriftung (role="radiogroup"). Mit ShowLabel="false" wird sie ausgeblendet und bleibt als aria-label erhalten.
Size skaliert die Radio-Kreise (OoSize.Xs bis OoSize.Xl). Tastatur: Tab in die Gruppe, Pfeiltasten wechseln die Auswahl.
ShowLabel="false"
Auswahl: M
oo-size-xs
Größe oo-size-xs
oo-size-sm
Größe oo-size-sm
oo-size-md
Größe oo-size-md
oo-size-lg
Größe oo-size-lg
oo-size-xl
Größe oo-size-xl
Lange Texte
Lange Optionstexte brechen um
Auswahl: Kurz
class & style
Beliebige HTML-Attribute (
class, style, data-*, aria-*) werden an den Wrapper durchgereicht.
class
Mit CSS-Klasse
style
Mit Inline-Style (grüner Border)
data-testid
Mit Test-Attribut
Validierung mit DataAnnotations
Integration in
EditContext via Form-Komponente und DataAnnotationsValidator. ShowValidationTooltip zeigt die Fehlermeldung inline am Feld.
SKILL.md – Radiobuttonlist
--- name: RadioButtonList description: Onesown Blazor Komponente RadioButtonList (Inputs). Verwende diesen Skill wenn du die RadioButtonList-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # RadioButtonList **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Inputs **Basisklasse:** `FormControlBase` **Generisch:** Ja (`RadioButtonList<TItem>` o.ae.) Generische Radio-Button-Gruppe für Einzelauswahl aus einer Liste von Einträgen mit DataAnnotations-Validierung. Unterstützt horizontale und vertikale Anordnung; Listenelemente liefern Anzeige und Wert über "Text"- und "Value"-Properties. **Live-Demo:** https://components.schini.com/demo/radiobuttonlist ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Value`` | ``TValue`` | | Aktuell gebundener Wert (der Value der gewählten Option). | | ``ValueChanged`` | ``EventCallback<TValue>`` | | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Auswahländerung ausgelöst. | | ``ValueExpression`` | ``Expression<Func<object>>`` | | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung und Label. | | ``Items`` | ``List<TItem>`` | ``new()`` | Liste der auswählbaren Elemente. Jedes Element sollte eine "Text"- (Anzeige) und "Value"-Property (gebundener Wert) haben. null wird wie eine leere Liste behandelt. | | ``Orientation`` | ``RadioButtonListOrientation`` | ``RadioButtonListOrientation.Vertical`` | Anordnung der Radio-Buttons. Mögliche Werte: Vertical (Standard), Horizontal. | | ``Disabled`` | ``bool`` | | Deaktiviert alle Radio-Buttons: keine Auswahl möglich, ausgegraut. Standard: false. | ## Geerbte Parameter (FormControlBase) | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Size`` | ``string`` | ``OoSize.Md`` | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. | | ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). | | ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. | | ``IsFloatingLabel`` | ``bool`` | ``true`` | Aktiviert das schwebende Label (Floating Label), das beim Fokus oder bei Eingabe nach oben animiert. false = festes Label über dem Feld. Standard: true bzw. OoDefaults.Input.IsFloatingLabel. | | ``Label`` | ``string`` | | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. | | ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). | | ``AutoSaveCallback`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. | | ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. | | ``AfterValueChanged`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. | | ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. | ## Hinweise - Immer @bind-Value für Two-Way-Binding verwenden - Für Formular-Validierung ValueExpression="() => _model.Property" setzen - Komponente muss innerhalb eines <Form>- oder <EditForm>-Containers liegen, damit der EditContext greift - AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard) - AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit - ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld - Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang - Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus - TItem ist die Listenelement-Klasse mit "Text"- und "Value"-Properties, TValue der gebundene Werttyp (string, int?, Enum, …) - Fehlt eine "Text"-Property, wird ToString() des Elements angezeigt; fehlt "Value", ist das Element selbst der Wert (z. B. List<string>) - Horizontale Anordnung: Orientation="RadioButtonListOrientation.Horizontal" (bricht bei Platzmangel um) - Deaktivieren: Disabled="true" sperrt alle Radio-Buttons - Label wird als Gruppenbeschriftung über den Optionen angezeigt (role="radiogroup", aria-labelledby); ShowLabel="false" blendet sie aus, sie bleibt dann als aria-label erhalten - Tastatur: Tab fokussiert die Gruppe, Pfeiltasten wechseln die Auswahl (natives Radio-Verhalten) - Validierung: ValueExpression wird benötigt um DataAnnotations auszuwerten - Wert wird via @bind-Value gebunden; nur ein Wert gleichzeitig auswählbar - IsFloatingLabel hat hier keine Wirkung, das Label steht immer fest über den Optionen; OoDefaults.Input.IsFloatingLabel wird nicht übernommen