MarsalaDS

Buscar

Páginas e componentes da documentação

Sidebar

Início

Uso

Menu lateral para apps e painéis. SidebarProvider + Sidebar + SidebarInset; grupos e SidebarMenuButton; tokens bg-sidebar.

Quando usar

  • Envolva layout em SidebarProvider; conteúdo principal em SidebarInset.
  • SidebarBrand no header (ícone recolhido, texto expandido); SidebarFooter para ícones secundários.
  • SidebarInsetHeader.actions: use SidebarInsetHeaderActions (tema + UserMenu) — vem com o pacote sidebar no registry.
  • Instale sidebar com CLI: puxa theme-toggle e user-menu; na raiz do app, ThemeProvider (next-themes).
  • SidebarProvider sem defaultOpen: inicia recolhida (modo ícone); ⌘B ou trigger no header para expandir.
  • collapsible padrão icon: recolhe para ícones; use tooltip (ou aria-label) em SidebarMenuButton.
  • offcanvas só se precisar esconder a barra.
  • No mobile (<768px) o menu abre em Drawer (swipe esquerda/direita).
  • Atalho ⌘B / Ctrl+B para alternar (toggleSidebar).

Evite quando

  • Não use para passos de um fluxo — Stepper.
  • Não empilhe várias sidebars fixas no mesmo lado.
  • Evite itens longos sem ScrollArea no SidebarContent.

Instalação

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

pnpm dlx shadcn@latest add @youxgroup/sidebar

Exemplos

Variações comuns de uso.

Navegação básica

Início

Várias seções

Início

Árvore com pastas

Início
Marsala Design System