SidebarLayout

CommandPalette

Suchpalette wie Strg+K in GitHub oder VS Code: Ein Dialog mit Suchfeld, darunter die Treffer einer frei wählbaren, auch asynchronen Suche. Pfeile wählen, Enter öffnet, Esc schließt. Geöffnet wird sie über einen eigenen Knopf oder über ein Tastenkürzel von jeder Seite aus (Standard Strg+Shift+F); in einer App steht sie einmal im Layout.

Grundlagen

Ein Knopf öffnet die Palette, ebenso Strg+Shift+F von überall auf der Seite. Tippen filtert, Pfeile wählen, Enter öffnet.
oder Strg+Shift+F
Gewählt: –
↑ ↓ auswählen · Enter öffnen · Esc schließen

Asynchrone Suche, Adressen und Freitext

Die Suche läuft asynchron, etwa gegen eine Datenbank. Jeder Treffer hat eine eigene Adresse (Mittel- und Strg-Klick öffnen einen neuen Tab), der letzte Eintrag sucht mit der Eingabe weiter. Diese Palette hat keine Tastenkürzel, damit sie sich nicht mit dem ersten Beispiel überschneidet.
Probier „12“, „druck“ oder „gibtsnicht“
Ergebnis: –
„12“ für eine Nummer, sonst ein Stück Titel – etwa „druck“.↑ ↓ auswählen · Enter öffnen · Esc schließen
SKILL.md – Commandpalette
---
name: CommandPalette
description: Onesown Blazor Komponente CommandPalette (Navigation). Verwende diesen Skill wenn du die CommandPalette-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# CommandPalette

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

Suchpalette wie Strg+K in GitHub oder VS Code: ein Dialog mit Suchfeld, darunter die Treffer einer frei wählbaren, auch asynchronen Suche (generisch über TItem) und optional zuletzt ein Eintrag für die Eingabe selbst, etwa „Überall suchen: …“. Mit Tastatur bedienbar (Pfeile, Enter, Esc) und von jeder Seite aus über Tastenkürzel zu öffnen.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Search`` | ``Func<string, Task<IReadOnlyList<TItem>>>`` | **Pflicht** | Liefert die Treffer zur getrimmten, nicht leeren Eingabe; läuft bei jeder Änderung der Eingabe. |
| ``ItemTemplate`` | ``RenderFragment<TItem>`` | **Pflicht** | Inhalt einer Trefferzeile (in einem ListItem), etwa Titel und darunter eine gedämpfte Zeile mit Herkunft. |
| ``OnSelect`` | ``EventCallback<TItem>`` |  | Ein Treffer wurde per Klick oder Enter gewählt. Die Palette ist dann schon geschlossen. |
| ``ItemKey`` | ``Func<TItem, object>`` |  | Eindeutiger Schlüssel eines Treffers für das Neuzeichnen der Liste. Standard: null (der Treffer selbst). |
| ``ItemIcon`` | ``Func<TItem, string>`` |  | Material-Symbol vor einem Treffer, etwa „book“ oder „adjust“. Standard: null (kein Symbol). |
| ``ItemHref`` | ``Func<TItem, string>`` |  | Eigene Adresse eines Treffers: Mittel- und Strg-Klick öffnen sie in einem neuen Tab. Standard: null (kein Link). |
| ``Placeholder`` | ``string`` | ``"Suchen"`` | Platzhalter und zugleich zugänglicher Name des Suchfelds. Standard: „Suchen“. |
| ``Hint`` | ``RenderFragment`` |  | Steht unter dem leeren Suchfeld, etwa was man eingeben kann. Standard: null (nichts). |
| ``FreeTextLabel`` | ``Func<string, string>`` |  | Text des letzten Eintrags zur Eingabe, etwa text =&gt; $"Überall suchen: „{text}“". Standard: null (kein solcher Eintrag). |
| ``FreeTextHref`` | ``Func<string, string>`` |  | Adresse des letzten Eintrags für Mittel- und Strg-Klick, etwa eine Suchseite mit der Eingabe. Standard: null (kein Link). |
| ``OnFreeText`` | ``EventCallback<string>`` |  | Der letzte Eintrag (FreeTextLabel) wurde gewählt; liefert die Eingabe. Die Palette ist dann schon geschlossen. |
| ``FreeTextIcon`` | ``string`` | ``"manage_search"`` | Material-Symbol des letzten Eintrags. Standard: „manage_search“. |
| ``NoResultsText`` | ``string`` | ``"Keine Treffer"`` | Text, wenn die Suche nichts findet und es keinen FreeTextLabel-Eintrag gibt. Standard: „Keine Treffer“. |
| ``Hotkeys`` | ``IReadOnlyList<string>`` | ``new[] { "shift+f" }`` | Tastenkürzel, die zusammen mit Strg (am Mac Cmd) die Palette von jeder Seite aus öffnen: ein Buchstabe, optional mit „shift+“ oder „alt+“ davor, etwa „shift+f“ für Strg+Shift+F oder „k“ für Strg+K. Leer = keine Tastenkürzel. Standard: „shift+f“. |
| ``Width`` | ``string`` | ``"40rem"`` | Breite des Dialogs als CSS-Wert. Standard: „40rem“. |
| ``ShowKeyHints`` | ``bool`` | ``true`` | Zeigt unten die Tastenhilfe „↑ ↓ auswählen · Enter öffnen · Esc schließen“. Standard: true. |

## Geerbte Parameter (OoComponentBase)

Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` |  | 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. |

## Hinweise

- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Öffnen über einen eigenen Knopf mit @ref: &lt;Button Text="Springe zu" Icon="search" OnClick="@(() => _palette.Open())" /&gt; und &lt;CommandPalette @ref="_palette" … /&gt;
- Search liefert die Treffer zur getrimmten, nicht leeren Eingabe: Search="@(text => SucheAsync(text))" mit Rückgabe Task&lt;IReadOnlyList&lt;TItem&gt;&gt;; ein spätes Ergebnis zu einer älteren Eingabe wird verworfen
- ItemTemplate zeigt eine Trefferzeile (etwa Titel fett und darunter eine gedämpfte Zeile), ItemIcon das Symbol davor, OnSelect bekommt den gewählten Treffer – die Palette ist dann schon zu
- ItemHref gibt jedem Treffer eine eigene Adresse: Mittel- und Strg-Klick öffnen sie in einem neuen Tab, ein normaler Klick ruft nur OnSelect auf
- FreeTextLabel="@(text => $"Überall suchen: „{text}“")" mit OnFreeText hängt einen letzten Eintrag für die Eingabe selbst an, etwa zur Volltextsuche
- Hotkeys: Tastenkürzel, die mit Strg (am Mac Cmd) die Palette öffnen, als „buchstabe“ oder mit „shift+“/„alt+“ davor; Standard „shift+f“ (Strg+Shift+F). Hotkeys="@(new[] { "k" })" für Strg+K; Strg+T, Strg+N und Strg+W gibt der Browser nicht her; nur eine Palette je Seite sollte Tastenkürzel haben
- Der erste Treffer ist vorgewählt; Pfeile wählen (am Ende geht es oben weiter), Enter wartet auf die laufende Suche und wählt dann
- Steht der Knopf in einer dunklen Kopfzeile, die Palette außerhalb davon platzieren (etwa neben Toaster und DialogHost), damit sie die Farben der Seite hat


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.