FileUpload
A drop zone with a browse button; files reach the host via upload, listed back in files.
Group: Inputs · Kind: native · in the lite catalog
Preview
Section titled “Preview”Platforms
Section titled “Platforms”The same specimen painted by React, SwiftUI, Compose and gpui.




| Prop | Type | Required | Bindable | Description |
|---|---|---|---|---|
label |
string |
– | – | The field label. |
name |
string |
yes | – | The field’s key in the submitted data. |
accept |
string |
– | – | Accepted types, comma-separated (image/*,.pdf). |
multiple |
boolean |
– | – | Allows more than one file. Default false. |
maxSize |
number |
– | – | Max bytes per file; bigger ones are refused. |
files |
[file] |
– | yes | The attached files, each removable. |
hint |
string |
– | – | Text under the drop zone’s title. |
disabled |
boolean |
– | – | Shows it inert. Default false. |
Events
Section titled “Events”on.upload: runs an actionon.remove: runs an action
None.
Children
Section titled “Children”none
A2UI basic mapping
Section titled “A2UI basic mapping”No basic catalog component maps here.
Built from
Section titled “Built from”A native component: every renderer paints it directly.
Accessibility
Section titled “Accessibility”Role: button
button (the drop zone) + a list of files with remove buttons
| Keys | Action |
|---|---|
Enter Space on the drop zone |
open the file picker |
| – | Tab reaches each file’s remove button |
Theming
Section titled “Theming”Recipe parts: FileUpload/root FileUpload/label FileUpload/dropzone FileUpload/icon FileUpload/hint FileUpload/file FileUpload/fileName FileUpload/fileMeta FileUpload/remove FileUpload/description FileUpload/error FileUpload/title FileUpload/browse FileUpload/fileIcon
Keyed by: multiple disabled :hover :pressed :focus :disabled :checked :open :selected :invalid :dragover
Related
Section titled “Related”Form · FieldGroup · FormActions · Input · Textarea · NumberField · Checkbox · Radio