MarsalaDS

Buscar

Páginas e componentes da documentação

Dropdown Menu

Uso

Menu flutuante ancorado a um gatilho (botão ou ícone) para ações contextuais. Posicione com side e align no DropdownMenuContent; agrupe com Label, Group e Separator; use CheckboxItem ou RadioGroup para preferências; Submenu para ramificações curtas.

Quando usar

  • Ícone Hugeicons à esquerda do label em cada item (padrão do DS).
  • Ações de linha (⋯) ou botão “Ações” com poucos itens.
  • Excluir, remover e similares: variant="destructive" no item (cor destructive no texto e no ícone).
  • Conta / preferências: Group + atalhos; “Sair” no fim com variant="destructive".
  • Toggles e tema: CheckboxItem ou RadioGroup com estado no cliente.
  • Ajuste side e align quando o menu cortar na borda da tela (ex.: align="end" em gatilho à direita).

Evite quando

  • Não use como navegação principal — prefira tabs ou sidebar.
  • Evite listas longas sem agrupar; para busca use Command.
  • Não misture muitos níveis de submenu — três níveis no máximo.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/dropdown-menu

Exemplos

Variações comuns de uso.

Ações rápidas

Conta com atalhos

Itens com checkbox

Seleção única (radio)

Submenu

Ação destrutiva

Gatilho ícone

Marsala Design System