Design System

Command

Paleta de comandos com busca e navegação por teclado. Construído sobre cmdk. Usado no AppSidebar como diálogo de busca rápida (atalho /).

import {
  Command, CommandEmpty, CommandGroup,
  CommandInput, CommandItem, CommandList,
} from "@workspace/ui/components/command";

<Command>
  <CommandInput placeholder="Buscar..." />
  <CommandList>
    <CommandEmpty>Nenhum resultado.</CommandEmpty>
    <CommandGroup heading="Navegação">
      <CommandItem>Página Inicial</CommandItem>
      <CommandItem>Consultoras</CommandItem>
    </CommandGroup>
  </CommandList>
</Command>

Inline

Command embutido como campo de busca filtrado.

Anatomia

Estrutura do componente Command.

ComponenteFunção
CommandInputCampo de busca com ícone de lupa
CommandListContainer de resultados com scroll (máx. 300px)
CommandEmptyMensagem quando não há resultados
CommandGroupAgrupamento com heading opcional
CommandItemItem selecionável via teclado/mouse
CommandSeparatorDivisor entre grupos
CommandShortcutAtalho de teclado (alinhado à direita)

API Reference

PropTypeDefaultDescrição
CommandInput.placeholderstringTexto placeholder do campo de busca
CommandGroup.headingstringTítulo do grupo de itens
CommandItem.onSelect(value: string) => voidCallback ao selecionar um item
CommandItem.disabledbooleanfalseDesabilita o item
CommandShortcut.childrenReactNodeTexto do atalho (ex: ⌘K)
CommandDialogDialogPropsWrapper que abre o Command dentro de um Dialog modal