FORMA Docs

Command launcher

Arcs Command Palette im Overlay: ⌘K von überall, Filter als Chips, Treffer führen per Link oder Aktion weiter.

import { CommandLauncher } from "@/forma/modules/launch";
Base

In FORMA

  • Liegt in kit/modules/launch.tsx und ist über @/forma/modules/launch erreichbar.
  • FORMAs eigener Baustein, auf Arc gebaut: Arcs Buttons, Felder und Federn darunter, Farbe, Ecken, Höhen und Tempo aus der Richtung.

Usage

import { CommandLauncher } from "@/forma/modules/launch";

Arcs CommandPalette (Suche, Gruppen, Tastatur, Bewegung) in einem Overlay, ergänzt um Filter als Chips über den Treffern. Ein Feld, darunter und die Treffer in Gruppen (Zuletzt, Aktionen, Personen …), jeweils mit Icon, Name und einer Zeile. Pfeiltasten wandern, Enter öffnet, Esc schließt; mit hotkey öffnet ⌘K sie von überall.

  • Wann: viele Ziele oder Aktionen, die man lieber tippt als sucht – Admin-Oberflächen, Werkzeuge, Agenten.
  • Treffer führen per href (über FORMAs Router) oder onSelect.
  • Filter gruppieren über kind; „Alle“ steht immer vorne.
  • Für eine Palette ohne Overlay (eingebettet in eine Seite) direkt Arcs CommandPalette nehmen.
  • Die Suche im Sidebar-Kopf (chromeSearch) bleibt für die Navigation; die Palette ist für alles, was darüber hinausgeht.

API reference

PropTyp
open, onOpenChangeboolean, (open) => voidgesteuert
itemsLaunchItem[]Treffer; group ordnet sie
filters{ value, label }[]Chips; ein Treffer gehört über kind dazu
placeholderstringFeldtext
hotkeyboolean⌘K öffnet und schließt
LaunchItem{ id, label, description?, icon?, group?, kind?, keywords?, href?, onSelect? }

Komponente und Text: Arc UI (MIT, uiarc.dev), angepasst für FORMA.