SidebarLayout

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: 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: 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.

Pflichtfeld
Farbe (Pflichtfeld)
Pflichtfeld (int?)
Priorität (Pflichtfeld)
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 &lt;Form&gt;- oder &lt;EditForm&gt;-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&lt;string&gt;)
- 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


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.