EEnterUI
DocsComponentsThemesDonation
Get Started
      • StatGrid
      • KPISection
      • UsageMeter
      • PlanUsage
      • FileList
EnterUIDocsProduct OperationsProduct SurfacesUsage and FilesFileList
Product OperationsUpdated 6 May 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
NextMeter

On this page

  1. Default usage
  2. Import
  3. Accessibility
  4. API
  5. Styling