SidebarLayout

GuidedDatePicker

Geführte Datumsauswahl in drei Schritten: Jahr → Monat → Tag. Ein Popup öffnet sich mit scrollbaren Listen für Jahr und Monat sowie einem Kalender-Grid für den Tag.

Standard

Geführte Auswahl – zuerst Jahr, dann Monat, dann Tag.

Wert: –

Nicht-nullable (DateTime)

Gleiche Komponente mit nicht-nullable DateTime als TValue. Clear-Icon entfällt da der Wert nicht null werden kann.

Wert: 19.11.2026

Jahresbereich einschränken

MinYear / MaxYear begrenzen nur die Jahresliste – Monate und Tage bleiben frei wählbar.

Wert: –

Monatsbereich einschränken

MinMonth / MaxMonth blenden Monate außerhalb des Bereichs aus – unabhängig vom gewählten Jahr. Nützlich z.B. für saisonale Buchungen.

Wert: –

Tag-Bereich einschränken

MinDay / MaxDay deaktivieren Tage außerhalb des Bereichs im Kalender – unabhängig von Monat und Jahr. Nützlich z.B. für Monatsanfang/-mitte.

Wert: –

Kombinierte Einschränkung

Alle Dimensionen sind beliebig kombinierbar. Hier: nur Jahre 2020–2025, nur Monate März–Oktober, nur Tage 1–20.

Wert: –

Ohne Floating Label

Mit IsFloatingLabel="false" steht das Label wie bei TextBox und Select fest über dem Feld; Kalender- und Löschen-Symbol bleiben im Eingabefeld.

Wert: 17.05.1990, –

Readonly

Readonly="true" – Feld und Popup sind vollständig deaktiviert, Clear-Icon wird ausgeblendet.

Ohne Icons

ShowClearIcon="false" ShowPickerIcon="false" – minimale Darstellung ohne Icons. Das Feld öffnet das Popup per Klick ins Eingabefeld.

Wert: –

Benutzerdefinierte Icons

PickerIconTemplate und ClearIconTemplate ersetzen die Standard-Icons durch eigene Inhalte.

Wert: –

AfterValueChanged Callback

AfterValueChanged wird nach jeder Wertänderung ausgelöst – unabhängig von der Gültigkeit. Geeignet für Live-Vorschau oder Seiteneffekte.

Callback ausgelöst: 0 ×

Validierung

Pflichtfeld-Validierung mit ShowValidationTooltip und ValueExpression.

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

# GuidedDatePicker

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  
**Generisch:** Ja (`GuidedDatePicker<TItem>` o.ae.)  

Geführter Datums-Picker mit drei Schritten: Jahr → Monat → Tag. Öffnet ein Popup mit scrollbaren Listen für Jahr und Monat sowie einem Kalender-Grid für die Tag-Auswahl.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``TValue`` |  | Aktuell gebundener Wert (DateTime oder DateTime?). |
| ``ValueChanged`` | ``EventCallback<TValue>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung. |
| ``ShowClearIcon`` | ``bool`` | ``true`` | Zeigt ein X-Symbol zum Zurücksetzen des Werts. Standard: true. |
| ``Readonly`` | ``bool`` |  | Setzt das Feld in den Nur-Lesen-Modus. Standard: false. |
| ``CustomValidationMethod`` | ``Func<TValue, bool>`` |  | Optionale zusätzliche Validierungsfunktion. Gibt true zurück wenn der Wert gültig ist. |
| ``CustomValidationMessage`` | ``string`` | ``"Ungültiger Wert"`` | Fehlermeldung wenn CustomValidationMethod false zurückgibt. Standard: "Ungültiger Wert". |
| ``MinYear`` | ``int?`` |  | Frühestes wählbares Jahr (1–9999). Begrenzt die Jahresliste von unten. Kombinierbar mit MaxYear, MinMonth usw. |
| ``MaxYear`` | ``int?`` |  | Spätestes wählbares Jahr (1–9999). Begrenzt die Jahresliste von oben. Kombinierbar mit MinYear, MaxMonth usw. |
| ``MinMonth`` | ``int?`` |  | Frühester wählbarer Monat (1–12). Blendet Monate davor in der Monatsliste aus – unabhängig vom gewählten Jahr. |
| ``MaxMonth`` | ``int?`` |  | Spätester wählbarer Monat (1–12). Blendet Monate danach in der Monatsliste aus – unabhängig vom gewählten Jahr. |
| ``MinDay`` | ``int?`` |  | Früheste wählbare Tag-Nummer (1–31). Deaktiviert Tage mit kleinerem Tag-Wert im Kalender-Grid – unabhängig von Monat und Jahr. |
| ``MaxDay`` | ``int?`` |  | Späteste wählbare Tag-Nummer (1–31). Deaktiviert Tage mit größerem Tag-Wert im Kalender-Grid – unabhängig von Monat und Jahr. |
| ``ShowPickerIcon`` | ``bool`` | ``true`` | Zeigt das Kalender-Icon rechts im Eingabefeld. Standard: true. |
| ``PickerIconTemplate`` | ``RenderFragment`` |  | Benutzerdefiniertes Template für das Picker-Icon (ersetzt Standard-Kalender-Icon). |
| ``ClearIconTemplate`` | ``RenderFragment`` |  | Benutzerdefiniertes Template für das Clear-Icon (ersetzt Standard-X). |

## 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
- TValue: DateTime oder DateTime? – nullable wird für optionale Felder empfohlen
- Der Benutzer wählt nacheinander Jahr, Monat und Tag aus
- Breadcrumb-Navigation erlaubt das Zurückgehen zu vorherigen Schritten
- Jahresbereich: heute -100 bis heute +100 Jahre (konfigurierbar via MinYear/MaxYear)
- Kein JavaScript erforderlich – rein in Blazor implementiert
- IsFloatingLabel="false": festes Label über dem Feld wie bei TextBox und Select; appweit über OoDefaults.Input.IsFloatingLabel


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.