SidebarLayout

Checkbox

Boolean-Eingabe mit konfigurierbarer Label-Position. Unterstützt Label links/rechts, ohne Label, Disabled, Größen, AfterValueChanged, AutoSaveCallback und Validierung.

Grundvarianten

Label rechts (Standard), Label links, ohne sichtbares Label (Label wird dann zum aria-label). Der Wert lässt sich auch von außen setzen.

Label rechts
Wert: False
Label links
Wert: True
Ohne Label
Wert: False

Beschriftung

Label wird als HTML gerendert (z. B. für einen Link). Lange Beschriftungen brechen um, auch ungetrennte Wörter.

HTML-Label
Wert: False
Langer Text
Wert: False

Zustände

Disabled: Checkbox ist vollständig deaktiviert – ausgegraut, halbtransparent, Cursor zeigt Sperre.

Disabled (inaktiv)
Disabled (aktiv)

Size

Alle fünf Größen von Xs bis Xl.

Xs
Sm
Md (Standard)
Lg
Xl

Events

AfterValueChanged feuert nach jeder Wertänderung.

AfterValueChanged
Änderungen: 0×

AutoSaveCallback

AutoSaveCallback wird nach jeder Wertänderung ausgelöst – standardmäßig nur wenn das Feld gültig ist (TriggerAutoSaveCallbackOnlyIfValid).

Nur bei gültigem Wert
Gespeichert: –
Immer speichern
Gespeichert: –

class & style

class und style landen am Wrapper, weitere HTML-Attribute (data-*, aria-*, tabindex) am nativen Input.

class
style
data-testid

Validierung mit DataAnnotations

Integration in EditContext via Form-Komponente. ShowValidationTooltip zeigt die Fehlermeldung inline.

SKILL.md – Checkbox
---
name: Checkbox
description: Onesown Blazor Komponente Checkbox (Inputs). Verwende diesen Skill wenn du die Checkbox-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# Checkbox

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  

Checkbox-Eingabefeld mit konfigurierbarer Label-Position, DataAnnotations-Validierung und AutoSave-Support. Bindet einen bool-Wert und unterstützt sowohl Links- als auch Rechts-Beschriftung.

**Live-Demo:** https://components.schini.com/demo/checkbox  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``IsFloatingLabel`` | ``bool`` | ``false`` | Ohne Wirkung: Die Checkbox hat kein schwebendes Label, der Text steht neben dem Kästchen. OoDefaults.Input.IsFloatingLabel gilt hier nicht. Standard: false. |
| ``LabelPosition`` | ``LabelPosition`` | ``LabelPosition.Right`` | Position des Label-Texts relativ zur Checkbox. Mögliche Werte: Right (Standard), Left. |
| ``ValueChanged`` | ``EventCallback<bool>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Wertänderung ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung. |
| ``Value`` | ``bool`` |  | Aktuell gebundener bool-Wert der Checkbox. |
| ``Disabled`` | ``bool`` |  | Deaktiviert die Checkbox: kein Klick, 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. |
| ``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
- Label links: LabelPosition="LabelPosition.Left" (Standard: rechts)
- Deaktivieren: Disabled="true" sperrt die Checkbox und graut sie aus
- Validierung: ValueExpression wird benötigt um DataAnnotations auszuwerten
- IsFloatingLabel hat hier keine Wirkung, der Text steht neben dem Kästchen; OoDefaults.Input.IsFloatingLabel wird nicht übernommen
- Ohne sichtbares Label (ShowLabel="false") wird Label als aria-label an das native Input gehängt
- Weitere Attribute (data-*, aria-*, tabindex) landen am nativen Input, class und style am Wrapper
- Label wird als HTML gerendert (z. B. für einen Link zu den AGB) – keine ungeprüften Benutzereingaben übergeben


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.