EnterUI
DocsComponentsThemesExamplesDonation
Get Started
      • StatGrid
      • KPISection
      • UsageMeter
      • PlanUsage
      • FileList

Default usage

  1. EnterUI
  2. /Docs
  3. /Product Operations
  4. /Product Surfaces
  5. /Usage and Files
  6. /FileList
Updated 3 October 2026

FileList

List of uploaded or attached files with name, size, progress, error, and remove action.

FileList renders attached files with their type icon, name, size, optional progress bar (uploading), and an error slot.

#Default usage

Two files

Pass items with id, name, and optional size/status/progress.

  • design.pdf512 KB
  • logo.png18 KB
Code
<FileList
  items={[
    { id: "a", name: "design.pdf", size: 524288 },
    { id: "b", name: "logo.png", size: 18432, status: "complete" }
  ]}
/>

#Import

Code
import {
  AttachmentList,
  FileList,
  type FileListItem,
  type FileListItemStatus,
} from "@froggdesign/enter-ui-react";

#Accessibility

Each remove control is a real <button> with aria-label="Remove {name}". Items use data-status so consumer styles can target progress / error states.

#API

  • items: FileListItem array (id, name, optional size, status, progress, error, icon).
  • onRemove(id): when set, renders a remove icon-button per item with an accessible label.
  • formatSize(bytes): customise the size formatter (defaults to KB/MB/GB).
  • AttachmentList is an alias for comment and message attachment surfaces.

#Styling

Every exported component accepts className. EnterUI styles use .eui-* classes and --eui-* variables mapped from FroggDesign theme tokens.

PreviousPlanUsage
NextSkeleton
On this page
  • Default usage
  • Import
  • Accessibility
  • API
  • Styling