MarsalaDS

Buscar

Páginas e componentes da documentação

Drawer

Uso

Único painel deslizante do design system (substitui Sheet). Entra por uma borda via swipeDirection: down, up, left ou right. Use para menus, filtros, detalhes e fluxos auxiliares — com direção diferente no mobile e no desktop quando fizer sentido.

Quando usar

  • Mobile: ações e formulários secundários com swipeDirection="down" (compartilhar, opções, substituto de Dialog).
  • Filtros: swipeDirection="right" no desktop (≥ md) e "down" no mobile — mesmo conteúdo, direction por breakpoint.
  • Detalhe lateral: "right" ou "left" em telas largas; bottom em telas pequenas se o layout lateral apertar.
  • showSwipeHandle e snapPoints quando arrastar ajuda (mapas, filtros longos).

Evite quando

  • Não duplique Sheet — lateral e inferior são Drawer com swipeDirection diferente.
  • Evite conteúdo longo sem rolagem interna no painel.
  • Não monte Dialog e Drawer abertos para o mesmo fluxo ao mesmo tempo.

Instalação

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

pnpm dlx shadcn@latest add @youxgroup/drawer

Exemplos

Variações comuns de uso.

Padrão

Com rodapé

Posições

Responsivo (filtros)

Snap points

Marsala Design System