Komponenten
Datei-Upload (FileUpload)
StabilDateien 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.
- uebergabe-bericht.pdf480 kB
- station-3.png1,2 MB
PDF und Bilder bis 5 MB – zum Beispiel der Übergabebericht einer Schicht.
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.
Nur PDF bis 2 MB – größere Dateien erscheinen als Fehler.
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“.
Enterund 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
progressbarmit 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/*.
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| accept | string | – | Nein | Accepted file types, as extensions, MIME types or wildcards like `image/*`. |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | Disables the dropzone and file picker. |
| files | UploadItem[] | – | Nein | Files to show in the list, usually the upload results. |
| maxSize | number | – | Nein | Largest accepted file size in bytes. |
| multiple | boolean | false | Nein | Allows selecting more than one file; defaults to `false`. |
| onFilesChange | (files: File[]) => void | – | Ja | Called with the files that passed the accept and size checks. |
| onRemove | ((id: string) => void) | – | Nein | Called with the id of a file whose remove button was pressed. |