Zum Inhalt springen
Dokumentation

Komponenten

Datei-Upload (FileUpload)

Stabil

Dateien auswählen oder ablegen, Größe und Typ prüfen und den Fortschritt sehen.

Der FileUpload nimmt Dateien per Auswahl oder per Ziehen und Ablegen an. Er prüft Typ und Größe, zeigt abgelehnte Dateien als Fehler und stellt die gewählten Dateien mit Größe und Fortschritt dar.

Wann verwenden

  • Für einen Übergabebericht, ein Foto oder ein Dokument, das zu einem Vorgang gehört.
  • Wenn mehrere Dateien gleichzeitig erlaubt sind, etwa Anhänge zu einem Ticket.
  • Wenn Größe oder Dateityp begrenzt sind und Nutzer sofort sehen sollen, warum eine Datei nicht angenommen wurde.

Wann nicht

  • Für einen einzelnen kurzen Text oder eine Notiz genügt Textarea.
  • Für Bilder, die direkt bearbeitet werden, gehört eine Vorschau mit Zuschneiden in einen eigenen Schritt.
  • Wenn Dateien nur angezeigt und nicht hochgeladen werden, ist eine Liste mit Download-Links einfacher.

Dateien auswählen

onFilesChange erhält die angenommenen File-Objekte. Mit multiple sind mehrere Dateien erlaubt; accept begrenzt den Typ, maxSize die Größe in Bytes. Die gewählten Dateien erscheinen über files mit Name, Größe, Fortschritt und einem Entfernen-Knopf.

Dateien hierher ziehen oder auswählen
  • uebergabe-bericht.pdf480 kB
  • station-3.png1,2 MB

PDF und Bilder bis 5 MB – zum Beispiel der Übergabebericht einer Schicht.

Beispiel und Quelltext
anhang.tsx
import * as React from "react";

import { FileUpload, type UploadItem } from "@neodin-eu/ui";

const start: UploadItem[] = [
  { id: "bericht", name: "uebergabe-bericht.pdf", size: 480_000 },
  { id: "foto", name: "station-3.png", size: 1_200_000, progress: 65 },
];

function Anhang() {
  const [dateien, setDateien] = React.useState<UploadItem[]>(start);

  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <FileUpload
        accept="image/*,.pdf"
        multiple
        maxSize={5_000_000}
        files={dateien}
        onRemove={(id) => setDateien((bisher) => bisher.filter((eintrag) => eintrag.id !== id))}
        onFilesChange={(gewaehlt) =>
          setDateien((bisher) => [
            ...bisher,
            ...gewaehlt.map((datei, index) => ({
              id: `${datei.name}-${bisher.length + index}`,
              name: datei.name,
              size: datei.size,
            })),
          ])
        }
      />
      <p className="text-xs text-muted-foreground">
        PDF und Bilder bis 5 MB – zum Beispiel der Übergabebericht einer Schicht.
      </p>
    </div>
  );
}

Grenzen und Fehler

Abgelehnte Dateien erscheinen in einem Bereich mit der Rolle alert und nennen den Grund, etwa „Datei ist größer als 5 MB“ oder „Dateityp nicht erlaubt“. Angenommene Dateien werden trotzdem weitergereicht.

Dateien hierher ziehen oder auswählen

Nur PDF bis 2 MB – größere Dateien erscheinen als Fehler.

Beispiel und Quelltext
grenzen.tsx
import * as React from "react";

import { FileUpload } from "@neodin-eu/ui";

function Grenzen() {
  const [meldung, setMeldung] = React.useState<string | null>(null);

  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <FileUpload
        accept=".pdf"
        maxSize={2_000_000}
        onFilesChange={(dateien) =>
          setMeldung(
            dateien.length === 1
              ? `„${dateien[0]?.name}“ ist bereit zum Hochladen.`
              : `${dateien.length} Dateien sind bereit zum Hochladen.`,
          )
        }
      />
      <p className="text-xs text-muted-foreground" role="status">
        {meldung ?? "Nur PDF bis 2 MB – größere Dateien erscheinen als Fehler."}
      </p>
    </div>
  );
}

Barrierefreiheit

  • Die Ablagefläche ist eine Schaltfläche mit dem Namen „Dateien hierher ziehen oder auswählen“. Enter und die Leertaste öffnen die Dateiauswahl; beides prüft der Komponententest.
  • Ziehen und Ablegen funktioniert ebenfalls; der Test prüft die Übergabe der Dateien.
  • Abgelehnte Dateien stehen in einem Bereich mit der Rolle alert. Der Komponententest prüft die Meldungen für zu große und für unerlaubte Dateien.
  • Der Fortschritt einer Datei ist ein progressbar mit dem Dateinamen als Namen und einem Wert zwischen 0 und 100.
  • Jede Datei hat einen Entfernen-Knopf mit eigenem Namen, zum Beispiel „bericht.pdf entfernen“.
  • Die Komponente ist in hell und dunkel frei von axe-Verstößen.

Props

Die Tabelle wird aus den Typen der Bibliothek erzeugt. maxSize wird in Bytes angegeben; accept nimmt Endungen wie .pdf, genaue Typen wie image/png oder Muster wie image/*.

Props von FileUpload
PropTypStandardPflichtBeschreibung
acceptstring–NeinAccepted file types, as extensions, MIME types or wildcards like `image/*`.
classNamestring–Nein–
disabledboolean–NeinDisables the dropzone and file picker.
filesUploadItem[]–NeinFiles to show in the list, usually the upload results.
maxSizenumber–NeinLargest accepted file size in bytes.
multiplebooleanfalseNeinAllows selecting more than one file; defaults to `false`.
onFilesChange(files: File[]) => void–JaCalled with the files that passed the accept and size checks.
onRemove((id: string) => void)–NeinCalled with the id of a file whose remove button was pressed.

Siehe auch