UnitValueBox
Ein Wert gleichzeitig in zwei bis vier Darstellungen, etwa Stunden, Tage und Prozent. Der gebundene Wert bleibt immer in der Einheit des Hauptfelds; Eingaben in anderen Darstellungen werden dorthin zurückgerechnet.
Stunden, Tage und Prozent
Wert in Stunden, 100 % = 100 h, Faktor 8 für Tage. Eingaben in Tagen oder Prozent werden in Stunden zurückgerechnet.
Wert in Stunden: 50
Schmale Breiten
Die Box füllt die Breite ihres Containers. Hier in 20, 14 und 10 rem Breite sowie mit zwei statt drei Abschnitten.
Wert in Stunden: 30
Eigene Einheiten
Beliebige Einheiten: Wert in Metern mit Zentimetern und Kilometern (Faktor 0,01 und 1000), ohne Prozent.
Wert in Metern: 1500
Min/Max und fehlender 100-%-Wert
Min/Max gelten in der Einheit des Werts (0 bis 40 h). Ohne 100-%-Wert ist das Prozentfeld deaktiviert.
Wert in Stunden: 20
SKILL.md – Unitvaluebox
---
name: UnitValueBox
description: Onesown Blazor Komponente UnitValueBox (Inputs). Verwende diesen Skill wenn du die UnitValueBox-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# UnitValueBox
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Inputs
**Basisklasse:** `FormControlBase`
Eingabe eines Werts, der gleichzeitig in zwei bis vier Darstellungen angezeigt und bearbeitet wird, zum Beispiel Stunden, Tage und Prozent. Das Hauptfeld zeigt den Wert in der Einheit, in der er gebunden ist; weitere Felder zeigen ihn über Faktoren oder als Prozent vom 100-%-Wert. Eingaben in einem Feld werden in die Einheit des Werts zurückgerechnet und aktualisieren schon während des Tippens alle anderen Felder.
**Live-Demo:** https://components.schini.com/demo/unitvaluebox
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``decimal?`` | | Aktueller Wert in der Einheit des Hauptfelds (Parameter Unit). Null bedeutet leer. |
| ``ValueChanged`` | ``EventCallback<decimal?>`` | | EventCallback für Two-Way-Binding mit @bind-Value. Liefert den Wert immer in der Einheit des Hauptfelds, auch wenn in einer anderen Darstellung eingegeben wurde. Feuert schon während des Tippens bei jeder gültigen Eingabe. |
| ``ValueExpression`` | ``Expression<Func<object>>`` | | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung und Floating-Label-Text. |
| ``FullValue`` | ``decimal?`` | | Wert, der 100 % entspricht, in der Einheit des Werts (Bezugsgröße). Null oder 0 macht Prozent-Darstellungen nicht berechenbar. |
| ``Unit`` | ``string`` | | Beschriftung der Einheit des Werts, also des Hauptfelds, etwa „h“ oder „Stunden“. |
| ``Decimals`` | ``int`` | ``2`` | Nachkommastellen der Anzeige im Hauptfeld. Standard: 2. |
| ``Representations`` | ``IReadOnlyList<UnitRepresentation>`` | | Weitere Darstellungen neben dem Hauptfeld (maximal drei, weitere werden ignoriert). Die Reihenfolge entspricht der Anzeige. |
| ``Min`` | ``decimal?`` | | Kleinster erlaubter Wert in der Einheit des Werts. Null: keine Untergrenze. |
| ``Max`` | ``decimal?`` | | Größter erlaubter Wert in der Einheit des Werts. Null: keine Obergrenze. |
| ``CustomValidationMethod`` | ``Func<decimal?, bool>`` | | Optionale zusätzliche Validierungsfunktion für den Wert in der Einheit des Werts. true bedeutet gültig. |
| ``ReadOnly`` | ``bool`` | | Setzt alle Felder in den Nur-Lesen-Modus. 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 <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
- Einfachstes Beispiel: <UnitValueBox @bind-Value="_stunden" FullValue="100" Unit="h" Representations="_darstellungen" />
- Darstellungen: List<UnitRepresentation> mit bis zu drei Einträgen, etwa new UnitRepresentation { Label = "Tage", Factor = 8 } und UnitRepresentation.Percent()
- Die Einheit der Ausgabe ist immer die Einheit des Werts: Wert in Stunden, Eingabe 2 Tage ergibt Value = 16 (h), Eingabe 25 % von 100 h ergibt Value = 25 (h)
- Live-Aktualisierung: ValueChanged und AfterValueChanged feuern bei jeder gültigen Eingabe; das gerade bearbeitete Feld behält den getippten Text bis zum Verlassen, unvollständige Eingaben ändern den Wert nicht
- AutoSaveCallback feuert erst beim Verlassen des Felds bzw. mit Enter
- Rundung betrifft nur die Anzeige (Decimals je Darstellung); der gebundene Wert behält die volle Genauigkeit
- Prozent ist ohne 100-%-Wert (null oder 0) nicht berechenbar; dieses Feld ist dann leer und deaktiviert
- Min und Max gelten in der Einheit des Werts und prüfen auch Eingaben in den anderen Darstellungen