MarsalaDS

Buscar

Páginas e componentes da documentação

Attachment

briefing.pdf240 KB

Uso

Bloco compacto para exibir um arquivo anexado, com mídia, título e metadados. Pensado para chat, upload e revisão antes do envio.

Quando usar

  • horizontal (row) para lista de arquivos; vertical (column) para grade de imagens.
  • AttachmentMedia variant="image" com <img> para fotos; variant="icon" com ícone para PDF e similares.
  • Estados idle (anexar), uploading, processing, error e done.
  • AttachmentGroup para vários anexos com rolagem horizontal.
  • AttachmentActions para baixar ou remover quando o fluxo exige.

Evite quando

  • Não substitua lista de arquivos complexa só com vários Attachment soltos.
  • Evite anexo sem ação (baixar, remover) quando o fluxo exige interação.
  • Não use para preview de imagem em tela cheia — use componente de mídia adequado.

Instalação

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

pnpm dlx shadcn@latest add @youxgroup/attachment

Exemplos

Variações comuns de uso.

Arquivo (ícone, row)

briefing.pdf240 KB

Imagem (row)

produto-hero.jpg1,2 MB

Imagem (column)

produto-hero.jpg1,2 MB

Área para anexar

Anexar arquivoPDF, PNG ou JPG até 10 MB

Enviando

enviando.pdfEnviando...

Processando

briefing.pdfProcessando...

Com erro

briefing.pdfFalha no envio. Tente novamente.

Com ações

briefing.pdf240 KB

Grupo rolável

foto-01.jpg820 KB
notas.pdf120 KB
contrato.pdfEnviando...
Marsala Design System