SidebarLayout

FilterInput

Filterfeld mit Vorschlagsmenü wie die Filterleiste von GitHub. Im selben Textfeld entstehen mehrere Bedingungen der Form key:wert. Das Menü schlägt zum Wort am Cursor zuerst Felder, dann deren Werte und bei mehrstufigen Werten die nächste Ebene vor. Nach einem Leerzeichen beginnt es wieder bei den Feldern. Mehrere Werte mit Komma sind ODER (label:bug,feature), verschiedene Bedingungen UND. Ein Klick auf Feld oder Wert einer bestehenden Bedingung bietet Tauschen, Hinzufügen und Entfernen an. Pfeiltasten wählen, Enter oder Tab übernimmt, Escape schließt.

Einstufig: Feld → Wert

Ein einziges Feld status mit festen Werten. Ins Feld klicken, status wählen, Wert wählen.

Wert:

Wie GitHub: mehrere Felder, Ausschließen, Freitext

Felder is, assignee (mit Avatar), label (mit Farbe), milestone und das Freitext-Feld title. Mehrere Werte mit Komma sind ODER (label:bug,enhancement). Ein Klick auf Feld oder Wert einer Bedingung bietet Tauschen, Hinzufügen und Entfernen an. Unbekannte Felder oder Werte erscheinen als Warnung. Enter löst OnSearch aus.

Wert: is:open assignee:@me label:bug,enhancement -label:wontfix

Zuletzt gesucht (Enter):

Key Values (ODER) Exclude Freitext
is open
assignee @me
label bug | enhancement
label wontfix ja

Mehrstufig: Feld → Wert → Unterwert → …

repo hat zwei Ebenen (Organisation / Repository), ort drei (Land / Bundesland / Stadt). Werte mit Unterwerten zeigen einen Pfeil; nach der Auswahl folgt die nächste Ebene. Werte mit Leerzeichen kommen in Anführungszeichen.

Wert:

Datenbankwerte: Enum, Ids und Zahlen

Im Text steht der lesbare Wert (status:inarbeit), beim Auswerten liefert GetData<int>() die Datenbankwerte als Liste. status kommt aus einem Enum (FilterInputField.FromEnum), prio aus einer Id-Liste (Data = Id), punkte ist ein Zahlenfeld ohne Werteliste. Werte mit Komma sind mit ODER verknüpft (status:offen,inarbeit), verschiedene Bedingungen mit UND; Freitext sucht im Titel.

Wert: status:offen,inarbeit -prio:niedrig

Key Text GetData<int>() Matches[].Data Exclude
status offen | inarbeit 1, 2 Offen (AufgabenStatus), InArbeit (AufgabenStatus)
prio niedrig 30 30 (Int32) ja

Gefilterte Aufgaben (3 von 6):

Titel StatusId PrioId Punkte
Login reparieren 2 (InArbeit) 10 8
Export als Excel 1 (Offen) 20 5
Suche beschleunigen 2 (InArbeit) 20 8

Vorbelegt, Größen, Readonly, Disabled

Vorbelegter Filtertext (auch mit ungültigem Wert), Size, festes Label mit IsFloatingLabel="false", Readonly und Disabled. Neben einem Button gleich hoch bei gleicher Size und gleichem IsFloatingLabel.

Validierung

Pflichtfeld-Validierung mit ShowValidationTooltip.

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

# FilterInput

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

Filterfeld mit Vorschlagsmenü wie die Filterleiste von GitHub: Im selben Textfeld entstehen mehrere Bedingungen der Form „key:wert“ (z. B. „is:open assignee:tschinagl -label:bug“). Das Menü schlägt passend zum Wort am Cursor zuerst Felder, dann deren Werte und bei mehrstufigen Werten die nächste Ebene vor. Nach einem Leerzeichen beginnt es wieder bei den Feldern.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``string`` |  | Der Filtertext, z. B. "is:open label:bug". Für Two-Way-Binding mit @bind-Value. |
| ``ValueChanged`` | ``EventCallback<string>`` |  | Wird bei jeder Änderung des Filtertexts ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Für DataAnnotations-Validierung und Label-Text. |
| ``Fields`` | ``List<FilterInputField>`` | ``new()`` | Die Filterfelder mit ihren Werten. Reihenfolge = Reihenfolge im Vorschlagsmenü. |
| ``OnSearch`` | ``EventCallback<string>`` |  | Wird ausgelöst, wenn Enter gedrückt wird und das Vorschlagsmenü nichts zur Auswahl hat. Liefert den Filtertext. |
| ``ShowErrors`` | ``bool`` | ``true`` | Zeigt unter dem Feld eine Warnung, wenn der Filter unbekannte Felder, leere oder ungültige Werte enthält. Standard: true. |
| ``AllowClear`` | ``bool`` | ``true`` | Zeigt rechts ein X zum Leeren des Filters. Standard: true. |
| ``Icon`` | ``string`` | ``"search"`` | Material-Symbol links im Feld. Leer = kein Icon. Standard: "search". |
| ``ExcludeLabelFormat`` | ``string`` | ``"{0} ausschließen"`` | Text für den Ausschließen-Vorschlag, {0} = Feldname. Standard: "{0} ausschließen". |
| ``IncludeLabelFormat`` | ``string`` | ``"{0} einschließen"`` | Text zum Aufheben des Ausschließens beim Klick auf ein ausgeschlossenes Feld, {0} = Feldname. Standard: "{0} einschließen". |
| ``RemoveLabel`` | ``string`` | ``"Bedingung entfernen"`` | Text des Eintrags zum Entfernen der angeklickten Bedingung. Standard: "Bedingung entfernen". |
| ``AddValueLabel`` | ``string`` | ``"Wert hinzufügen"`` | Text des Eintrags beim Klick auf einen Wert, der per Komma einen weiteren Wert (ODER) anhängt. Standard: "Wert hinzufügen". |
| ``RemoveValueLabel`` | ``string`` | ``"Wert entfernen"`` | Text des Eintrags zum Entfernen des angeklickten Werts, wenn die Bedingung mehrere Werte hat. Standard: "Wert entfernen". |
| ``MaxSuggestions`` | ``int`` | ``50`` | Maximale Anzahl Vorschläge im Menü. Standard: 50. |
| ``MenuMaxHeight`` | ``string`` |  | Höchsthöhe des Vorschlagsmenüs als CSS-Wert (z. B. "40rem" oder "min(40rem, 70vh)"); darüber scrollt es. Mit weniger Einträgen bleibt das Menü so hoch wie sein Inhalt. Standard: null (20rem aus dem CSS). |
| ``Disabled`` | ``bool`` |  | Deaktiviert das Feld. Standard: false. |
| ``Readonly`` | ``bool`` |  | Nur lesen: Text sichtbar, aber nicht änderbar, kein Menü. Standard: false. |
| ``CustomValidationMethod`` | ``Func<string, bool>`` |  | Optionale zusätzliche Validierungsfunktion. Gibt true zurück, wenn der Filtertext gültig ist. |

## 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
- Einfachstes Beispiel: &lt;FilterInput Fields="_felder" @bind-Value="_filter" /&gt;
- Felder: Liste von FilterInputField mit Key, Label, Icon und Values (FilterInputValue)
- Mehrstufig: FilterInputValue.Values befüllen; die Ebenen werden mit FilterInputField.Separator getrennt („repo:onesown/wiki“)
- Freitext-Feld: FilterInputField ohne Values, optional mit Hint („title:“ + beliebiger Text)
- Ausschließen: „… ausschließen“ setzt ein „-“ vor das Feld; abschaltbar mit FilterInputField.AllowExclude="false"
- Werte mit Leerzeichen werden automatisch in Anführungszeichen gesetzt (label:"in arbeit")
- Auswerten: FilterInputParser.Parse(text, fields) liefert die Bedingungen als List&lt;FilterInputCondition&gt; samt passendem Feld (Field) und Werten (Values, Matches)
- Farbe am Wert: FilterInputValue.Color färbt das Icon (Icon = "bolt", Color = "#d73a4a"); ohne Icon erscheint ein Farbpunkt (etwa für Labels)
- Personen als Wert: FilterInputValue mit AvatarName (Tooltip und Initialen), optional AvatarKuerzel = "TS" für ein eigenes Kürzel im Kreis oder AvatarUrl für ein Bild
- Datenbankwerte: FilterInputValue.Data = 3 (z. B. Status-Id); im Text steht weiter "status:offen", bedingung.GetData&lt;int&gt;() liefert [3]
- Enums: FilterInputField.FromEnum&lt;MeinStatus&gt;("status") erzeugt die Werte samt [Display]-Namen und Data = Enum-Wert
- Enter ohne offenes Menü löst OnSearch aus; ShowErrors zeigt unbekannte Felder und Werte als Warnung
- Ohne sichtbares Label (ShowLabel="false") wird Label als aria-label an das Eingabefeld gehängt
- ODER: mehrere Werte mit Komma („label:bug,feature“ = bug oder feature); verschiedene Bedingungen sind mit UND verknüpft, „-label:bug,feature“ = weder noch
- Auswerten mehrerer Werte: bedingung.Values bzw. bedingung.GetData&lt;int&gt;() liefert eine Liste, z. B. für ids.Contains(x.StatusId)
- Mausklick in eine bestehende Bedingung: Klick aufs Feld zeigt alle Felder zum Tauschen (der Wert fällt dabei weg), dazu „… ausschließen/einschließen“ und „Bedingung entfernen“; Klick auf einen Wert zeigt „Wert hinzufügen“, alle übrigen Werte dieses Felds bzw. dieser Ebene und bei mehreren Werten „Wert entfernen“
- Klick auf ein Stichwort ohne Feld: die Feldwahl macht es zum Wert („bug“ → „label:bug“)
- Tippen filtert wie gewohnt nach dem Text links vom Cursor
- Tastatur: Pfeil auf/ab wählt, Enter oder Tab übernimmt, Escape schließt das Menü
- Schwebendes Label wie bei der TextBox (IsFloatingLabel, Standard true bzw. OoDefaults.Input.IsFloatingLabel); IsFloatingLabel="false" stellt das Label fest über das Feld
- Höhe aus Size wie TextBox und Button: neben einem Button gleich hoch bei gleicher Size (Button-Standard ist Xs, Eingabefelder Md) und gleichem IsFloatingLabel (mit schwebendem Label am Button IsFloatingLabel="true")


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.