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
Ansicht wählen
Wert: –
Mit Clear-Button
Ansicht wählen
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
Liste
Wert: liste
Mehrfachauswahl mit Zusammenfassung
Dateien, Personen
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)
Kurz
Width="15rem"
Kurz
Width="100%"
Kurz
Breiter als der Container
Kurz
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.
Liste
Wert: liste
Gemischte Items
Normale
ContextMenuItem-Aktionen, Separatoren und Href-Links können beliebig eingemischt werden.
Aktions-Item oben
Version vergleichen
Wert: –
Gruppen mit Header
Exportformat wählen
Wert: –
Numerischer Wert
TValue="int" – Value-Binding funktioniert mit jedem Typ.
Priorität
Mittel
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
Standard · Mittel
Wert: mittel, Aufwand: Mittel
Größen
Size skaliert Höhe und Schriftgröße: OoSize.Xs | Sm | Md (Standard) | Lg | Xl.
Xs
Wählen
Sm
Wählen
Md (Standard)
Wählen
Lg
Wählen
Xl
Wählen
Gemeinsam gebundener Wert
Wert: –
Farben
ButtonStyle nimmt die gleichen OoColorPalette-Token wie der Button.
Neutral
Primary
Secondary
Success
Danger
Warning
Wert: –
Outline & Ghost
Wie beim Button:
OoColorPalette.Primary.Outline / .Ghost.
Primary Outline
Neutral Outline
Danger Outline
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.
Anna Bauer
Werte: Anna Bauer
Einfachauswahl mit Filter
Branch wählen wie bei GitHub.
master
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 | bottom | left | 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: <SelectMenu @bind-Value="_wert" Placeholder="Bitte wählen"> + <SelectMenuItem Value="1" Text="Option A" /> - 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: <TriggerContent Context="text">@text <small>Zusatz</small></TriggerContent> – 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<TValue>) – 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"