Sidebar
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/sidebarExemplos
Variações comuns de uso.