SidebarLayout

FileDrop

Universeller Drag-&-Drop- und Paste-Wrapper. Macht beliebige Kind-Komponenten zur Drop-Zone für Dateien und Bilder – per Drag & Drop oder Strg+V.

TextBox mit Datei-Drop (Below)

Dateien auf das Textfeld ziehen oder ins Feld klicken und Strg+V drücken. Bilder erscheinen als Thumbnails, andere Dateien als Chips unterhalb des Feldes.

EagerLoad – sofortiger Transfer (Standard)

EagerLoad="true" (Standard): Dateidaten werden unmittelbar nach dem Drop per Chunking übertragen. Während des Transfers ist ein Spinner am Chip / Thumbnail sichtbar.

EagerLoad="false" – manueller Transfer

EagerLoad="false": Dateien werden zunächst nur als Metadaten registriert – keine Bytes übertragen. Erst nach Klick auf „Jetzt übertragen" werden die Daten per Chunking vom Browser geholt.

Durchsuchen-Button

ShowBrowseButton="true" blendet einen Button ein der einen nativen Datei-Dialog öffnet – zusätzlich zu Drop und Strg+V. Optional: BrowseButtonText und BrowseMultiple.

Thumbnails & Chips Above

Mit ThumbnailPosition="Above" erscheinen Thumbnails und Chips oberhalb des Feldes.

Nur Bilder akzeptieren

AcceptFiles="false" – andere Dateitypen werden ignoriert, nur Bilder (image/*) werden angenommen.

Nur Nicht-Bild-Dateien akzeptieren

AcceptImages="false" – Bilder werden ignoriert, nur Dokumente, PDFs etc. werden angenommen.

TextArea als Drop-Zone

FileDrop funktioniert mit beliebigen Kind-Komponenten – hier mit einer TextArea.

Mehrere Felder in einer Drop-Zone

Eine FileDrop-Zone kann mehrere Kind-Elemente umschließen. Drop und Paste funktionieren in allen Feldern.

OnFilesChanged Callback

Über OnFilesChanged reagiert die Seite sofort auf jede Dateilisten-Änderung.

–

Chat-Look – eigener Button und freie Attachment-Position

Mit PlaceAttachmentsInsideContent="true" erscheinen Thumbnails/Chips nicht mehr automatisch ober-/unterhalb des Inhalts. Stattdessen platziert man sie über context.AttachmentsFragment an beliebiger Stelle innerhalb des ChildContents.

Maximale Dateigröße (MaxFileSize)

Dateien die größer als MaxFileSize sind werden JS-seitig abgelehnt – kein SignalR-Transfer findet statt. Standard: 10 MB. Hier auf 500 KB eingestellt zum Testen.

Dateien serverseitig speichern



SKILL.md – Filedrop
---
name: FileDrop
description: Onesown Blazor Komponente FileDrop (Inputs). Verwende diesen Skill wenn du die FileDrop-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# FileDrop

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `OoComponentBase`  

Universeller Wrapper der beliebige Kind-Inhalte zur Drag-&-Drop- und Paste-Zone für Dateien macht. Unterstützt Dateien und Bilder aus der Zwischenablage (Strg+V) sowie per Drag & Drop. Bilder werden als Thumbnails, andere Dateien als Chips dargestellt. WICHTIG – Einbindung in andere Projekte: Die Dateidaten werden in 1 MB Chunks als Base64 über SignalR übertragen. Der SignalR-Default (32 KB) reicht dafür nicht aus. In Program.cs muss zwingend folgendes konfiguriert werden: builder.Services.AddRazorComponents() .AddInteractiveServerComponents() .AddHubOptions(o => o.MaximumReceiveMessageSize = 10 * 1024 * 1024); Ohne diese Einstellung bricht SignalR die Verbindung ab, sobald eine Datei größer als etwa 24 KB ist.

**Live-Demo:** https://components.schini.com/demo/filedrop  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``ChildContent`` | ``RenderFragment<FileDropContext>`` |  | Kind-Inhalt der zur Drop/Paste-Zone wird. Bekommt über den Parameter context Zugriff auf , damit innerhalb des Inhalts ein Button den Datei-Dialog öffnen kann. |
| ``ThumbnailPosition`` | ``OoFileDropPosition`` | ``OoFileDropPosition.Below`` | Position der Datei-Thumbnails und Chips relativ zum Kind-Inhalt. Below (Standard): unterhalb; Above: oberhalb; None: keine Anzeige. Wird ignoriert wenn true ist. |
| ``PlaceAttachmentsInsideContent`` | ``bool`` |  | Wenn true, werden Thumbnails/Chips nicht ober- bzw. unterhalb des ChildContents gerendert, sondern ausschließlich über innerhalb des ChildContents platziert. Thumbnails und Chips haben dann keinen eigenen Außenabstand; den Abstand bestimmt der umgebende Inhalt. Standard: false. |
| ``AcceptImages`` | ``bool`` | ``true`` | Akzeptiert Bilddateien (image/*) per Paste und Drop. Standard: true. |
| ``AcceptFiles`` | ``bool`` | ``true`` | Akzeptiert Nicht-Bild-Dateien per Paste und Drop. Standard: true. |
| ``AllowedExtensions`` | ``string`` |  | Optionale Whitelist erlaubter Dateiendungen als kommagetrennte Liste (ohne Punkt, Kleinschreibung). Beispiel: "pdf,docx,xlsx". Wenn angegeben, haben AcceptImages und AcceptFiles keine Wirkung mehr – es werden ausschließlich Dateien mit diesen Endungen akzeptiert. Leer (Standard) = alle Dateitypen werden akzeptiert (gefiltert nach AcceptImages / AcceptFiles). |
| ``MaxFileSize`` | ``long`` | ``1000L * 1024 * 1024`` | Maximale Dateigröße in Bytes pro Datei. Dateien die größer sind werden JS-seitig abgelehnt und über gemeldet – es erfolgt kein Chunk-Transfer. Standard: 1000 MB. Auf 0 setzen um das Limit zu deaktivieren. |
| ``OnFilesRejected`` | ``EventCallback<List<string>>`` |  | Wird ausgelöst wenn Dateien wegen Überschreitung von abgelehnt wurden. Liefert eine Liste der abgelehnten Dateinamen. |
| ``Files`` | ``List<DropFile>`` | ``new()`` | Aktuelle Liste aller Dateien (Bilder + sonstige). Unterstützt Two-Way-Binding via @bind-Files. |
| ``FilesChanged`` | ``EventCallback<List<DropFile>>`` |  | EventCallback für Two-Way-Binding. Wird nach jeder Änderung der Dateiliste ausgelöst. |
| ``OnFilesChanged`` | ``EventCallback<List<DropFile>>`` |  | Wird zusätzlich zu ausgelöst wenn sich die Dateiliste ändert. |
| ``EagerLoad`` | ``bool`` | ``true`` | Wenn true (Standard), werden Dateidaten sofort nach dem Drop per Chunking übertragen. Wenn false, werden nur Metadaten empfangen – Bytes erst nach explizitem Aufruf von übertragen. |
| ``ShowBrowseButton`` | ``bool`` | ``false`` | Blendet einen „Durchsuchen"-Button ein der einen nativen Datei-Dialog öffnet. Standard: false. |
| ``BrowseButtonText`` | ``string`` | ``"Durchsuchen"`` | Beschriftung des Durchsuchen-Buttons. Standard: „Durchsuchen". |
| ``BrowseMultiple`` | ``bool`` | ``true`` | Erlaubt die Auswahl mehrerer Dateien über den Durchsuchen-Dialog. Standard: true. |

## Geerbte Parameter (OoComponentBase)

Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` |  | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |

## Hinweise

- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Dateien empfangen: <c>@bind-Files</c> oder <c>OnFilesChanged</c>
- Nur Bilder: <c>AcceptImages="true" AcceptFiles="false"</c>
- Nur Dateien (keine Bilder): <c>AcceptImages="false" AcceptFiles="true"</c>
- Position der Thumbnails/Chips: <c>ThumbnailPosition="OoFileDropPosition.Below"</c> (Standard)
- Größenlimit: <c>MaxFileSize</c> in Bytes – zu große Dateien werden JS-seitig abgelehnt und über <c>OnFilesRejected</c> gemeldet
- SignalR-Limit: MaximumReceiveMessageSize in Program.cs auf mind. 10 MB setzen (Chunks von 1 MB als Base64)
- Eigener Button für den Datei-Dialog im ChildContent: Attribut <c>data-oo-filedrop-browse="true"</c> setzen, z. B.
- <c>&lt;Button Icon="attach_file" data-oo-filedrop-browse="true" /&gt;</c>. Der Dialog öffnet dann direkt im Browser –
- nötig für iPhone/iPad, wo Safari einen Dialog nach einem Server-Roundtrip (<c>OnClick</c> → <c>context.OpenFileSelectorAsync()</c>) blockiert.


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.