SidebarLayout

ColorPicker

Farbauswahl mit vordefinierten Farbpaletten oder freiem Farbwähler. Unterstützt eigene Farblisten, Orientierung, Größen, AfterValueChanged, AutoSave und Validierung.

Grundvarianten

Standard mit Dropdown-Palette und nativer Farbwahl via ShowPicker.

Standard (Dropdown)
Wert:
Mit nativem Picker
Wert: #6366f1
Ohne Label
Wert:

Eigene Farblisten

Über Colors kann eine beliebige Liste von Hex-Farben übergeben werden.

Teamfarben
Wert:
Graustufen
Wert:

Feste Farben plus eigene Farbe

Mit AllowCustomColor bleiben die Swatches die Standardauswahl; das Regenbogenfeld am Ende öffnet bei Bedarf den nativen Farbdialog.

Wert: #0969da

Orientierung

Orientation steuert, ob Label und Farb-Button vertikal oder horizontal angeordnet werden.

Vertical (Standard)
Horizontal

Size

Alle fünf Größen von Xs bis Xl – alle Felder teilen denselben Bindewert.

Xs
Sm
Md (Standard)
Lg
Xl
Aktueller Wert

AfterValueChanged

AfterValueChanged wird nach jeder Farbauswahl ausgelöst.

Callback zählen
Änderungen: 0×

AutoSaveCallback

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

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

Validierung mit DataAnnotations

Integration in EditContext via Form-Komponente. ShowValidationTooltip zeigt Fehlermeldungen inline.

class & style

Beliebige HTML-Attribute (class, style, data-*, aria-*) werden an den Wrapper durchgereicht.

class
style
data-testid
SKILL.md – Colorpicker
---
name: ColorPicker
description: Onesown Blazor Komponente ColorPicker (Inputs). Verwende diesen Skill wenn du die ColorPicker-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# ColorPicker

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

Farbauswahl-Komponente mit vordefinierten Farb-Swatches und einem nativen Color-Input-Dialog. Unterstützt horizontale und vertikale Ausrichtung der Swatches und speichert Farben als Hex-String.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``string`` |  | Aktuell gebundener Farbwert als Hex-String (z.B. "#ff0000"). |
| ``ValueChanged`` | ``EventCallback<string>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Farbauswahl ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung. |
| ``Colors`` | ``List<string>`` | ``new List<string> { "#b22222", "#FFFF00", "#008000" }`` | Liste der angezeigten Farb-Swatches als Hex-Strings. Standard: Rot, Gelb, Grün. |
| ``ShowPicker`` | ``bool`` | ``false`` | Öffnet den nativen Color-Dialog initial. Standard: false. |
| ``AllowCustomColor`` | ``bool`` | ``false`` | Hängt an die Swatches ein letztes Feld in Regenbogenfarben, das den nativen Color-Dialog öffnet: feste Auswahl als Standard, freie Farbe nur bei Bedarf. Wirkt nur ohne ShowPicker. Standard: false. |
| ``CustomColorText`` | ``string`` | ``"Eigene Farbe…"`` | Tooltip und Accessible-Name des Felds für die freie Farbe (nur mit AllowCustomColor). Standard: "Eigene Farbe…". |
| ``Orientation`` | ``ColorPickerOrientation`` | ``ColorPickerOrientation.Vertical`` | Ausrichtung der Swatch-Reihe. Mögliche Werte: Vertical (Standard), Horizontal. |
| ``AsButton`` | ``bool`` | ``false`` | Wendet den ButtonStyle auf das Farbfeld an (Rahmen aus dem Style). Ohne AsButton wird ein dünner, mit dem Theme kontrastierender Rahmen angezeigt. Die Füllung ist immer die gewählte Farbe (Value). Standard: false. |
| ``ButtonStyle`` | ``OoButtonStyle`` |  | Farbpalette / Variante für den Rahmen – nur relevant wenn AsButton="true". Standard: OoColorPalette.Neutral. |

## 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
- Farben definieren: Colors="new List&lt;string&gt; { "#ff0000", "#00ff00" }" setzt die Swatch-Auswahl
- Orientierung: Orientation="ColorPickerOrientation.Horizontal" für horizontale Reihe
- Picker öffnen: ShowPicker="true" zeigt initial den nativen Color-Dialog
- Feste Auswahl plus freie Farbe: Colors setzen und AllowCustomColor="true" – das Regenbogenfeld am Ende der Swatches öffnet den nativen Dialog; eine Farbe außerhalb der Liste markiert dieses Feld als ausgewählt
- Rahmen: Standardmäßig dünn und mit dem Theme kontrastierend. AsButton="true" übernimmt den Rahmen aus ButtonStyle (z.B. ButtonStyle="OoColorPalette.Primary.Outline")
- Wert ist ein Hex-String (z.B. "#b22222"); @bind-Value für Two-Way-Binding verwenden
- Validierung: ValueExpression wird benötigt um DataAnnotations auszuwerten
- IsFloatingLabel hat hier keine Wirkung, das Label steht immer fest über dem Feld; OoDefaults.Input.IsFloatingLabel wird nicht übernommen


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.