Oros UI

Search documentation

Search Oros UI pages and components.

Attachment

Displays files with metadata, progress, and actions.

Horizontal
sales-dashboard.pdfPDF · 2.4 MB
customer-import.csvCSV · 18 KB
message-renderer.tsxTypeScript · 12 KB
Vertical
sales-dashboard.pdfPDF · 2.4 MB
customer-import.csvCSV · 18 KB
message-renderer.tsxTypeScript · 12 KB
source-assets.zipZIP · 4.2 MB
quarterly-review.keyKeynote · 9 MB

Installation

Install Attachment from Oros with shadcn CLI 4.13.0.

pnpm dlx shadcn@4.13.0 add @oros/attachment

Usage

import {
  Attachment,
  AttachmentGroup,
  AttachmentMedia,
  AttachmentContent,
  AttachmentTitle,
  AttachmentDescription,
} from "@/components/ui/attachment"

Open the Source tab in the preview for a complete working example.

Anatomy

ExportResponsibility
AttachmentThe root component that owns the primary structure and state.
AttachmentGroupGroups related items into one logical set.
AttachmentMediaA composable part of the component anatomy.
AttachmentContentContains the primary visible content.
AttachmentTitleProvides the visible heading for the current region.
AttachmentDescriptionProvides supporting context for the current region.
AttachmentActionsA composable part of the component anatomy.
AttachmentActionProvides an action associated with the component.
AttachmentTriggerControls opening, selection, or disclosure behavior.

API Reference

Attachment exports 9 named entries. Component exports accept the props of their underlying HTML element or Base UI component, plus an optional className, unless the source defines a more focused type.

  • Attachment Component
  • AttachmentGroup Component
  • AttachmentMedia Component
  • AttachmentContent Component
  • AttachmentTitle Component
  • AttachmentDescription Component
  • AttachmentActions Component
  • AttachmentAction Component
  • AttachmentTrigger Component

Accessibility

  • Attachment adds no application-specific accessible name by itself; use semantic content and label any interactive descendants.
  • Do not communicate state or meaning through color alone, and verify the composed result at text zoom and with keyboard navigation.

Source

Attachment uses the standard shadcn API and is distributed through Oros. Installing it adds the component source and required dependencies to your app. The Source tab above shows a complete usage example.