Attachment

Displays a file or image attachment with media, metadata, upload state, and actions.

The Attachment component displays a file or image attachment, its media, name, metadata, optional actions, and upload state. Use it for chat composers, message threads, and upload lists.

Installation#

npmyarnpnpmbun
npx shadcn@latest add @rescript-shadcn/Attachment
Copy

Usage#

Copy<Attachment>
  <Attachment.Media>
    <Icons.FileText />
  </Attachment.Media>
  <Attachment.Content>
    <Attachment.Title> {"sales-dashboard.pdf"->React.string} </Attachment.Title>
    <Attachment.Description> {"PDF - 2.4 MB"->React.string} </Attachment.Description>
  </Attachment.Content>
  <Attachment.Actions>
    <Attachment.Action ariaLabel="Remove sales-dashboard.pdf">
      <Icons.X />
    </Attachment.Action>
  </Attachment.Actions>
</Attachment>

Composition#

CopyAttachment
├── Attachment.Media
├── Attachment.Content
│   ├── Attachment.Title
│   └── Attachment.Description
├── Attachment.Actions
│   └── Attachment.Action
└── Attachment.Trigger

Use Attachment.Group to lay out multiple attachments in a horizontally scrollable row.

Features#

• Icon and image media through Attachment.Media
• Upload states: Idle, Uploading, Processing, Error, and Done
• Three sizes and horizontal or vertical orientation
• A full-card Attachment.Trigger for preview/open interactions
• Scrollable, snapping Attachment.Group
• Custom styling through className on every part

Examples#

Image#

Set variant=Image on Attachment.Media and render an <img /> inside it. Use orientation=Vertical to stack the media above the content.

dashboard.pngPNG - 820 KB

research.jpgJPEG - 1.1 MB

View Code

States#

Set state to reflect the upload lifecycle. Uploading and Processing shimmer the title, and Error switches to a destructive treatment.

Group#

Wrap attachments in Attachment.Group to lay them out in a horizontally scrollable, snapping row.

Trigger#

Add Attachment.Trigger to make the whole card clickable while actions stay independently clickable.

Accessibility#

Attachment.Action is usually icon-only, so pass an ariaLabel that names the action and target. Attachment.Trigger covers the card with no visible text, so it should also receive an ariaLabel.

API Reference#

Attachment#

Attachment.Media#

Attachment.Trigger#