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