SidebarLayout

IconPicker

Auswahl eines Material Symbols aus rund 3.900 Icons – mit deutscher und englischer Suche, optionalem Kategorie-Filter und Tastatursteuerung. Gebunden wird der Ligatur-Name (z.B. delete).

Standard

Volles Feld mit Icon und Name. Suche z.B. nach „Papierkorb“, „Haus“, „loeschen“ oder „pfeil links“.

Wert: smart_toy

Ohne Rahmen

Borderless="true" zeigt nur das Icon ohne Rahmen und Pfeil – passt neben ein Textfeld mit Floating-Label, ohne dass die Höhe stört.

Wert: hub

Kompakt

Compact="true" zeigt nur das Icon mit kleinem Pfeil im Rahmen – z.B. in Toolbars oder Tabellenzeilen.

Wert: timer

Mit Kategorie-Filter

ShowCategoryFilter="true" blendet über dem Raster eine Kategorie-Auswahl ein.

Wert: –

Zustände & Größen

Statisches Label, Readonly, Disabled sowie Size.

Wert: –

Validierung

Pflichtfeld-Validierung mit ShowValidationTooltip.

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

# IconPicker

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

Auswahlfeld für Material Symbols (Outlined) mit aufklappbarem Icon-Raster, deutscher und englischer Volltextsuche, optionalem Kategorie-Filter, Tastatursteuerung und DataAnnotations-Validierung. Gebunden wird der Ligatur-Name als string.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``string`` |  | Ligatur-Name des gewählten Material Symbols, z.B. "delete". null/leer = keine Auswahl. |
| ``ValueChanged`` | ``EventCallback<string>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Auswahl oder beim Leeren ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird für DataAnnotations-Validierung und Label-Text aus [Display] benötigt. |
| ``Compact`` | ``bool`` |  | Kompakte Darstellung: nur das gewählte Icon mit kleinem Pfeil statt eines vollen Feldes mit Name. Standard: false. |
| ``Borderless`` | ``bool`` |  | Nur das Icon ohne Rahmen und ohne Pfeil (Hover-Hintergrund als Klick-Hinweis). Impliziert die kompakte Darstellung. Standard: false. |
| ``ShowCategoryFilter`` | ``bool`` |  | Blendet im aufgeklappten Bereich eine Kategorie-Auswahl (z.B. "Bedienelemente", "Kommunikation") ein. Standard: false. |
| ``ShowClearButton`` | ``bool`` | ``true`` | Zeigt ein X zum Zurücksetzen der Auswahl auf null (nur bei Compact="false"). Standard: true. |
| ``SearchPlaceholder`` | ``string`` | ``"Suchen – z.B. Haus, löschen, mail"`` | Platzhalter im Suchfeld des aufgeklappten Bereichs. Standard: "Suchen – z.B. Haus, löschen, mail". |
| ``Readonly`` | ``bool`` |  | Setzt das Feld in den Nur-Lesen-Modus: Icon wird angezeigt, Auswahl kann nicht geöffnet werden. |
| ``Disabled`` | ``bool`` |  | Deaktiviert das Feld vollständig: kein Klick, ausgegraut. Standard: false. |
| ``CustomValidationMethod`` | ``Func<string, bool>`` |  | Optionale zusätzliche Validierungsfunktion. Gibt true zurück wenn der Wert gültig ist, false wenn nicht. |

## 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
- Binding: @bind-Value="_model.Icon" liefert den Ligatur-Namen (z.B. "delete"), der direkt mit &lt;Icon Name="@_model.Icon" /&gt; gerendert werden kann
- Kompakt: Compact="true" zeigt nur das gewählte Icon mit kleinem Pfeil – Label dient dann als Tooltip/aria-label
- Ohne Rahmen: Borderless="true" zeigt nur das Icon ohne Rahmen und Pfeil – ideal links neben einer TextBox mit Floating-Label, da keine Höhe angeglichen werden muss
- Suche: findet über deutsche Begriffe ("Papierkorb", "loeschen"), Icon-Namen und englische Tags; mehrere Wörter müssen alle passen
- Kategorie-Filter: ShowCategoryFilter="true" blendet eine Kategorie-Auswahl über dem Raster ein
- Tastatur: Pfeiltasten bewegen die Markierung im Raster, Enter wählt (ohne Markierung den ersten Treffer), Esc schließt
- Nur Icons, die in der lokal ausgelieferten Schrift enthalten sind, werden angeboten (Index: update-material-symbols.ps1)
- Deutsche Suchbegriffe ergänzen: Inputs/IconPicker/Data/material-symbols-de.json (Icon-Name -> kommagetrennte Begriffe)


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.