SidebarLayout

SelectMenu

SelectMenu kombiniert einen Dropdown-Trigger mit Value-Binding. Der Trigger zeigt automatisch den Text des gewählten SelectMenuItem, mit ShowSelectedIcon="true" auch dessen Icon. Normale ContextMenuItem-Aktionen, Separatoren und Links können frei gemischt werden. Optional: Clear-Button zum Zurücksetzen.

Einfache Auswahl

Grundverhalten: gewähltes Item wird als Trigger-Text angezeigt. ShowClearButton erscheint sobald ein Wert gesetzt ist.

Ohne Clear

Wert: –

Mit Clear-Button

Wert: –

Icons der Auswahl im Trigger

ShowSelectedIcon="true" zeigt die Icons der Auswahl auch im geschlossenen Feld. Ohne Auswahl und bei Items ohne Icon bleibt der Trigger ohne ausgewähltes Icon. Eigenes TriggerContent hat Vorrang.
Einfachauswahl mit Clear

Wert: liste

Mehrfachauswahl mit Zusammenfassung
Ab drei Werten erscheint „3 ausgewählt“ ohne Icons.

Werte: dateien, personen

Feste und verfügbare Breite

Width bestimmt die Breite des geschlossenen Felds. Die Auswahl ist in allen Beispielen gekoppelt: kurze oder lange Option wählen, um die konstante Breite zu vergleichen. Das Overlay bleibt unabhängig.
Automatisch (Standard)
Width="15rem"
Width="100%"
Breiter als der Container
20rem angefordert, auf die verfügbaren 12rem begrenzt.

Wert: kurz

Dropdown-Pfeil optional ausblenden

ShowTriggerIcon="false" entfernt den Dropdown-Pfeil samt Abstand. Das Feld lässt sich weiterhin öffnen; Auswahl-Icon und Clear-Button sind unabhängig davon.

Wert: liste

Gemischte Items

Normale ContextMenuItem-Aktionen, Separatoren und Href-Links können beliebig eingemischt werden.

Aktions-Item oben

Wert: –

Gruppen mit Header

Wert: –

Numerischer Wert

TValue="int" – Value-Binding funktioniert mit jedem Typ.

Priorität

Wert: 2

Beschreibung, Haken & Trigger-Inhalt

Description am SelectMenuItem zeigt eine zweite Zeile im Menü. ShowCheckmark markiert das gewählte Item mit Haken statt Farbe. TriggerContent gestaltet den Trigger selbst; der Context ist der sonst angezeigte Text.

Modellauswahl

Wert: mittel, Aufwand: Mittel

Größen

Size skaliert Höhe und Schriftgröße: OoSize.Xs | Sm | Md (Standard) | Lg | Xl.

Xs
Sm
Md (Standard)
Lg
Xl
Gemeinsam gebundener Wert

Wert: –

Farben

ButtonStyle nimmt die gleichen OoColorPalette-Token wie der Button.

Wert: –

Outline & Ghost

Wie beim Button: OoColorPalette.Primary.Outline / .Ghost.

Wert: –

Mehrfachauswahl mit Filter

Multiple="true" mit @bind-Values, Haken bei gewählten, Menü bleibt offen; ab drei Werten „3 ausgewählt“. ShowFilter für lange Listen.

Werte: Anna Bauer

Einfachauswahl mit Filter

Branch wählen wie bei GitHub.

Wert: master

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

# SelectMenu

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Navigation  
**Basisklasse:** `ContextMenuBase`  
**Generisch:** Ja (`SelectMenu<TItem>` o.ae.)  

Dropdown-Auswahlmenü mit Value-Binding. Verhält sich wie ein ContextMenu, speichert aber den gewählten Wert und zeigt den Text sowie optional das Icon des aktiven SelectMenuItems im Trigger-Button an. SelectMenuItem-Elemente übernehmen IsActive und OnClick automatisch. Normale ContextMenuItem-Elemente (Aktionen, Separatoren, Href-Links) können frei gemischt werden.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``TValue`` |  | Aktuell gewählter Wert. |
| ``ValueChanged`` | ``EventCallback<TValue>`` |  | Callback wenn der Wert geändert wird. |
| ``ChildContent`` | ``RenderFragment`` |  | Inhalt des Panels – SelectMenuItem und ContextMenuItem Elemente. |
| ``Placeholder`` | ``string`` | ``"Auswählen"`` | Text der angezeigt wird wenn kein Wert gewählt ist. |
| ``Width`` | ``string`` |  | Breite des geschlossenen Auswahlfelds als CSS-Wert, etwa "15rem", "240px" oder "100%". Auf die verfügbare Breite begrenzt; lange Texte werden gekürzt. Die Overlay-Breite bleibt unabhängig. Standard: null (Breite nach Inhalt). |
| ``ShowTriggerIcon`` | ``bool`` | ``true`` | Zeigt das Icon rechts am Trigger (Dropdown-Pfeil). Standard: true. Bei false entfallen Icon und dessen Abstand; Auswahl-Icon und Clear-Button bleiben unabhängig. |
| ``TriggerIcon`` | ``string`` | ``"expand_more"`` | Icon rechts am Trigger (Dropdown-Pfeil), unabhängig vom Icon der Auswahl. Standard: expand_more. |
| ``ShowSelectedIcon`` | ``bool`` |  | Zeigt das Icon des gewählten SelectMenuItems neben seinem Text im Trigger. Standard: false. Bei Mehrfachauswahl erscheint je ausgewähltem Text dessen Icon; die Zusammenfassung ab MultipleSummaryFrom bleibt ohne Icons. Ohne Auswahl oder bei Items ohne Icon wird kein Icon ergänzt. Eigenes TriggerContent hat Vorrang. |
| ``ShowClearButton`` | ``bool`` |  | Zeigt einen X-Button zum Zurücksetzen des Wertes an. |
| ``ButtonStyle`` | ``OoButtonStyle`` | ``OoColorPalette.Neutral`` | Farb- und Stil-Token des Trigger-Buttons. Standard: OoColorPalette.Neutral. |
| ``Position`` | ``string`` | ``"bottom"`` | Öffnungsrichtung: top &#124; bottom &#124; left &#124; right. Standard: bottom. |
| ``ShowCheckmark`` | ``bool`` |  | Zeigt beim gewählten SelectMenuItem rechts einen Haken, statt es einzufärben. Standard: false. |
| ``TriggerContent`` | ``RenderFragment<string>`` |  | Optionaler eigener Inhalt des Trigger-Buttons, etwa um neben dem gewählten Eintrag eine zusätzliche Einstellung zu zeigen. Context ist der Text, der sonst angezeigt würde (Text des gewählten Items oder Placeholder). Hat Vorrang vor ShowSelectedIcon. |
| ``Disabled`` | ``bool`` |  | Sperrt die Auswahl: Der Trigger lässt sich nicht öffnen und erscheint abgeblendet. Standard: false. |
| ``Multiple`` | ``bool`` |  | Mehrfachauswahl: Ein Klick auf ein SelectMenuItem schaltet seinen Wert in Values um, das Menü bleibt offen und gewählte Items haben einen Haken. Gebunden wird dann @bind-Values statt @bind-Value. Standard: false. |
| ``Values`` | ``List<TValue>`` |  | Gewählte Werte bei Multiple="true", in der Reihenfolge der Auswahl. |
| ``ValuesChanged`` | ``EventCallback<List<TValue>>`` |  | Callback mit der neuen Liste, wenn sich die Auswahl bei Multiple="true" ändert (immer eine neue Liste). |
| ``MultipleSummaryFrom`` | ``int`` | ``3`` | Trigger-Text bei Mehrfachauswahl ab dieser Anzahl gewählter Werte: „3 ausgewählt“ statt der Texte mit Komma. 0 = immer die Texte. Standard: 3. |

## Hinweise

- Einfach: &lt;SelectMenu @bind-Value="_wert" Placeholder="Bitte wählen"&gt; + &lt;SelectMenuItem Value="1" Text="Option A" /&gt;
- Mit Aktions-Items: ContextMenuItem direkt neben SelectMenuItems einfügen
- Breite des Auswahlfelds: Width="15rem" oder Width="100%"; auf verfügbaren Platz begrenzt, unabhängig vom Overlay
- Dropdown-Pfeil ausblenden: ShowTriggerIcon="false"; Icon der Auswahl und Clear-Button bleiben unabhängig
- Clear-Button: ShowClearButton="true" – zeigt X-Button zum Zurücksetzen
- Positionierung: Position="bottom" (Standard) | top | left | right
- Haken beim gewählten Item statt Einfärbung: ShowCheckmark="true"
- Eigener Trigger-Inhalt: &lt;TriggerContent Context="text"&gt;@text &lt;small&gt;Zusatz&lt;/small&gt;&lt;/TriggerContent&gt; – Context ist der sonst angezeigte Text
- Icon der Auswahl im Trigger: ShowSelectedIcon="true"; bei Mehrfachauswahl neben jedem Text, bei Zusammenfassung ohne Icons
- Auswahl sperren: Disabled="true" – Trigger abgeblendet, öffnet nicht
- Mehrfachauswahl: Multiple="true" @bind-Values="_labels" (List&lt;TValue&gt;) – Klick schaltet um, Menü bleibt offen, Haken bei gewählten; Trigger zeigt „bug, docs“ bzw. ab MultipleSummaryFrom „3 ausgewählt“
- Lange Listen (Labels, Personen, Branches): ShowFilter="true" zeigt oben ein Filterfeld mit Fokus beim Öffnen; FilterPlaceholder="Labels filtern"
- Beim Filtern einen Eintrag zum Anlegen anbieten: @bind-FilterText und ein ContextMenuItem mit IgnoreFilter="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.