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.
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 <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
- Binding: @bind-Value="_model.Icon" liefert den Ligatur-Namen (z.B. "delete"), der direkt mit <Icon Name="@_model.Icon" /> 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)