SidebarLayout

EmailMultiselect

Mehrfachauswahl für E-Mail-Adressen mit Chip-Darstellung. Einträge kommen aus einer statischen Liste (Items) oder werden per ItemsQueryable debounced serverseitig gesucht. Freie Eingabe neuer Adressen mit E-Mail-Prüfung ist möglich.

Statische Liste

Standardfall mit Items und @bind-Value. Tastatur: Pfeiltasten markieren, Enter wählt, Escape/Tab schließt, Backspace im leeren Suchfeld entfernt den letzten Chip. Ab zwei Chips erscheint rechts der Button „Alle zurücksetzen“.

Wert: anna.berger@example.com

Serverseitige Suche (ItemsQueryable)

ItemsQueryable durchsucht 500 Adressen erst ab MinSearchCharacters (hier 2) Zeichen, verzögert um DebounceMilliseconds (hier 300 ms). MaxSearchResults begrenzt die Treffer auf 10. Vorbelegte Werte werden beim Laden aus dem Queryable nachgeladen. In echten Anwendungen ist das z. B. ein EF-Core-DbSet.

Wert: mitarbeiter007@firma.example

Split-Suche

UseSplitSearch="true": Jedes Wort wird einzeln gesucht – „max example“ findet „max.mustermann@example.com“.

Wert:

Freie Eingabe

AllowCustomValue="true": Neue Adresse eintippen und mit Enter, Tab, Komma, Strichpunkt oder Klick daneben übernehmen – auch mit Namen („Anna <anna@example.com>“); eingefügte Listen werden aufgeteilt. ItemsChanged liefert den Text, die Seite ergänzt Items, der Eintrag wird automatisch ausgewählt. Mit ValidateCustomEmail (Standard) werden nur gültige E-Mail-Adressen übernommen; das zweite Feld erlaubt mit ValidateCustomEmail="false" beliebigen Text (z. B. Verteilerlisten).

Wert:

Wert:

Readonly, Disabled und MaxItems

Readonly zeigt die Chips ohne Entfernen-Button, Disabled sperrt das Feld vollständig. MaxItems="2" erlaubt höchstens zwei Adressen – danach zeigt die Liste einen Hinweis.

Wert: anna.berger@example.com

Liste offen lassen und Callbacks

ClosePopupOnSelect="false": Die Liste bleibt nach der Auswahl offen, mehrere Adressen lassen sich hintereinander wählen. AfterValueChanged und AutoSaveCallback werden nach jeder Änderung ausgelöst.

Wert:

AfterValueChanged: 0 × · AutoSaveCallback: 0 ×

Templates

ListItemTemplate, ChipItemTemplate, ChipItemRemoveBtnTemplate und NoRecordsTemplate (Suche nach „xyz“ zeigt den eigenen Leer-Hinweis).

Wert: max.mustermann@example.com

Label-Varianten und Size

IsFloatingLabel="false" zeigt das Label fest über dem Feld und den Placeholder im leeren Feld, ShowLabel="false" blendet es aus. Darunter die Größen Xs bis Xl mit gemeinsamem Bindewert.

Wert:

Wert: anna.berger@example.com, support@example.com

Lange Adressen und viele Chips

Schmale Breite (max. 18rem) mit vielen und sehr langen Adressen – Chips brechen um und lange Texte werden gekürzt (vollständiger Text als Tooltip).

Wert: anna.berger@example.com, max.mustermann@example.com, lisa.huber@example.org, buchhaltung.und.controlling.oesterreich@sehr-lange-domain-beispiel.example.com

class & style

Zusätzliche CSS-Klassen und Inline-Styles werden an den Wrapper weitergereicht.

Wert:

Validierung

Pflichtfeld (mindestens ein Empfänger) per DataAnnotations mit ShowValidationTooltip, dazu CustomValidationMethod: Adressen der Domain „spam.test“ sind nicht erlaubt.

Wert:

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

# EmailMultiselect

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  
**Generisch:** Ja (`EmailMultiselect<TItem>` o.ae.)  

Mehrfach-Auswahlfeld für E-Mail-Adressen mit Suche via IQueryable (async/debounced), Chip-Darstellung und DataAnnotations-Validierung. Unterstützt sowohl statische Listen als auch serverseitige Suche mit Mindestzeichenanzahl und Debounce.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Items`` | ``List<TItem>`` | ``new()`` | Statische Liste der auswählbaren E-Mail-Einträge. Alternativ oder zusätzlich ItemsQueryable für serverseitige Suche verwenden. |
| ``ItemsQueryable`` | ``IQueryable<TItem>`` |  | IQueryable für serverseitige Suche (z.B. EF Core DbSet). Wird automatisch mit dem Suchbegriff gefiltert. Alternativ oder zusätzlich zu Items. |
| ``ItemsChanged`` | ``EventCallback<string>`` |  | Wird ausgelöst wenn AllowCustomValue=true und der Nutzer einen neuen Wert übernimmt (Enter, Tab, Komma, Strichpunkt, Klick daneben). Liefert den eingetippten Text; der Aufrufer ergänzt damit Items. |
| ``Readonly`` | ``bool`` |  | Setzt den Nur-Lesen-Modus: Dropdown nicht öffenbar, Chips sichtbar aber nicht entfernbar. |
| ``Disabled`` | ``bool`` |  | Deaktiviert das Feld vollständig: kein Klick, ausgegraut, Chips nicht entfernbar. Standard: false. |
| ``ClosePopupOnSelect`` | ``bool`` | ``true`` | Schließt die Dropdown-Liste nach der Auswahl eines Eintrags. Standard: true. |
| ``AllowCustomValue`` | ``bool`` | ``false`` | Erlaubt die Eingabe freier Textwerte (z.B. direkte E-Mail-Eingabe) die nicht in Items vorhanden sind. Standard: false. |
| ``ValidateCustomEmail`` | ``bool`` | ``true`` | Lässt bei AllowCustomValue nur Freitext zu, der eine gültige E-Mail-Adresse ist, bloß oder mit Namen („Anna &lt;a@b.at&gt;“). Standard: true. |
| ``ListItemTemplate`` | ``RenderFragment<TItem>`` |  | Benutzerdefiniertes Template für die Darstellung jedes Listenelements im Dropdown. |
| ``ChipItemTemplate`` | ``RenderFragment<TItem>`` |  | Benutzerdefiniertes Template für die Darstellung jedes ausgewählten Chips. |
| ``ChipItemRemoveBtnTemplate`` | ``RenderFragment`` |  | Benutzerdefiniertes Template für den Entfernen-Button in jedem Chip. |
| ``NoRecordsTemplate`` | ``RenderFragment`` |  | Template das angezeigt wird wenn die gefilterte Liste leer ist. |
| ``Value`` | ``List<TValue>`` | ``new()`` | Liste der aktuell ausgewählten Werte. |
| ``ValueChanged`` | ``EventCallback<List<TValue>>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Änderung ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung und Label. |
| ``CustomValidationMethod`` | ``Func<List<TValue>, bool>`` |  | Optionale zusätzliche Validierungsfunktion. Gibt true zurück wenn die Auswahl gültig ist. |
| ``MaxItems`` | ``int`` | ``1000`` | Maximale Anzahl auswählbarer Einträge. Ist sie erreicht, zeigt die Liste einen Hinweis statt weiterer Einträge. Standard: 1000. |
| ``MaxSearchResults`` | ``int`` | ``1000`` | Maximale Anzahl Treffer, die pro Suche angezeigt bzw. aus ItemsQueryable geladen werden. Standard: 1000. |
| ``UseSplitSearch`` | ``bool`` |  | Sucht nach jedem Wort des Suchbegriffs einzeln statt dem gesamten Begriff. Standard: false. |
| ``MinSearchCharacters`` | ``int`` | ``2`` | Minimale Zeichenanzahl bevor die Suche in ItemsQueryable startet. Standard: 2. |
| ``DebounceMilliseconds`` | ``int`` | ``300`` | Wartezeit in Millisekunden nach der letzten Eingabe bevor die Suche in ItemsQueryable ausgelöst wird (Debounce). Standard: 300. |

## 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
- TItem muss ISelectListItem implementieren; TValue ist der gebundene Werttyp (meist string = E-Mail-Adresse)
- Serverseitige Suche: ItemsQueryable statt (oder zusätzlich zu) Items verwenden – Suche wird automatisch debounced; die Items-Liste des Aufrufers wird dabei nicht verändert
- Mindestzeichen: MinSearchCharacters (Standard: 2) gibt vor ab wie vielen Zeichen in ItemsQueryable gesucht wird
- Debounce: DebounceMilliseconds (Standard: 300) verhindert zu häufige Suchanfragen beim Tippen
- Freitext: AllowCustomValue="true" erlaubt direkte E-Mail-Eingabe; übernommen wird bei Enter, Tab, Komma, Strichpunkt und Klick daneben,
- eingefügte Listen („a@b.at, c@d.at“) werden aufgeteilt. ItemsChanged liefert den Text, der Aufrufer ergänzt Items und der neue Eintrag wird automatisch ausgewählt
- E-Mail-Prüfung: ValidateCustomEmail (Standard: true) lässt per Freitext nur gültige E-Mail-Adressen zu, bloß oder mit Namen („Anna &lt;a@b.at&gt;“)
- Maximale Auswahl: MaxItems begrenzt die Anzahl auswählbarer Einträge, MaxSearchResults die Trefferanzahl der Suche
- Chip-Templates: ChipItemTemplate und ChipItemRemoveBtnTemplate für eigene Chip-Darstellung
- Tastatur: Pfeiltasten markieren, Enter wählt bzw. übernimmt Freitext, Tab übernimmt und geht weiter, Escape schließt, Backspace im leeren Feld entfernt den letzten Chip


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.