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