Info alert:Beta feature
File upload - multiple is able to:
- Accept one or more files via browse or drag-and-drop
- Provide their data to you using file objects via the
onFileDrop
callback prop - Read files as dataURLs, calling provided callbacks as needed when files start/finish being read, as well as when the read succeeds or fails
- Display (in real time) the upload progress/status of each file
- Uploaded files are represented by the multiple file upload status item component, this component includes the aforementioned built-in file reading logic
- If you prefer to supply your own file reading logic and strictly use multiple file upload status item as a display component, the
customFileHandler
,fileName
,fileSize
,progressValue
, andprogressVariant
props exist to allow you to do that
Restricting file size and type
As with singular file upload, any props accepted by react-dropzone's Dropzone component can be passed as a dropzoneProps object in order to customize the behavior of the Dropzone, such as restricting the type of files allowed. The following examples will only accept the files they list as accepted. Note that file type determination is not reliable across platforms (see the note on react-dropzone's docs about the accept prop), so be sure to test the behavior of your file upload restriction on all browsers and operating systems targeted by your application.
IMPORTANT: A note about security
Restricting file sizes and types in this way is for user convenience only, and it cannot prevent a malicious user from submitting anything to your server. As with any user input, your application should also validate, sanitize and/or reject restricted files on the server side.
Examples
Props
MultipleFileUpload
Name | Type | Default | Description |
---|---|---|---|
children | React.ReactNode | Content rendered inside the multi upload field | |
className | string | Class to add to outer div | |
dropzoneProps | DropzoneProps | {} | Optional extra props to customize react-dropzone. |
isHorizontal | boolean | Flag setting the component to horizontal styling mode | |
onFileDrop | (data: File[]) => void | () => {} | When files are dropped or uploaded this callback will be called with all accepted files |
MultipleFileUploadMain
Name | Type | Default | Description |
---|---|---|---|
className | string | Class to add to outer div | |
infoText | React.ReactNode | Content rendered inside the info div | |
isUploadButtonHidden | boolean | Flag to prevent the upload button from being rendered | |
titleIcon | React.ReactNode | Content rendered inside the title icon div | |
titleText | React.ReactNode | Content rendered inside the title text div | |
titleTextSeparator | React.ReactNode | Content rendered inside the title text separator div |
MultipleFileUploadStatus
Name | Type | Default | Description |
---|---|---|---|
children | React.ReactNode | Content rendered inside multi file upload status list | |
className | string | Class to add to outer div | |
statusToggleIcon | 'danger' | 'success' | 'inProgress' | React.ReactNode | Icon to show in the status toggle | |
statusToggleText | string | String to show in the status toggle |
MultipleFileUploadStatusItem
Name | Type | Default | Description |
---|---|---|---|
buttonAriaLabel | string | 'Remove from list' | Adds accessibility text to the status item deletion button |
className | string | Class to add to outer div | |
customFileHandler | (file: File) => void | A callback to process file reading in a custom way | |
file | File | The file object being represented by the status item | |
fileIcon | React.ReactNode | A custom icon to show in place of the generic file icon | |
fileName | string | A custom name to display for the file rather than using built in functionality to auto-fill it | |
fileSize | number | A custom file size to display for the file rather than using built in functionality to auto-fill it | |
onClearClick | React.MouseEventHandler<HTMLButtonElement> | () => {} | Clear button was clicked |
onReadFail | (error: DOMException, onReadFail: File) => void | () => {} | A callback for when the FileReader API fails |
onReadFinished | (fileHandle: File) => void | () => {} | A callback for when a selected file finishes loading |
onReadStarted | (fileHandle: File) => void | () => {} | A callback for when a selected file starts loading |
onReadSuccess | (data: string, file: File) => void | () => {} | A callback for when the FileReader successfully reads the file |
progressAriaLabel | string | Adds accessible text to the progress bar. Required when title not used and there is not any label associated with the progress bar | |
progressAriaLabelledBy | string | Associates the progress bar with it's label for accessibility purposes. Required when title not used | |
progressId | string | Unique identifier for progress. Generated if not specified. | |
progressValue | number | A custom value to display for the progress component rather than using built in functionality to auto-fill it | |
progressVariant | 'danger' | 'success' | 'warning' | A custom variant to apply to the progress component rather than using built in functionality to auto-fill it |
CSS variables
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--GridTemplateColumns | 1fr | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--Gap | 1.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--TextAlign | center | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--GridTemplateColumns | auto | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--GridTemplateRows | auto | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--GridTemplateAreas | "title"
"upload"
"info" | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--Gap | 1rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--PaddingTop | 1.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--PaddingRight | 1.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--PaddingBottom | 2rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--PaddingLeft | 1.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--BorderWidth | 1px | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--BorderStyle | dashed | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--BorderColor | #d2d2d2 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__main--BackgroundColor | #fff | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title--Display | grid | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title--GridTemplateColumns | auto | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title--Gap | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title-icon--Color | #6a6e73 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title-text-separator--Display | block | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__title-text-separator--MarginTop | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__info--FontSize | 0.875rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__info--Color | #6a6e73 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__info--MarginTop | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main--BorderStyle | solid | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main--BorderColor | #06c | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main--BackgroundColor | #e7f1fa | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main__title-icon--Color | #06c | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main__title-text--Color | #06c | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-drag-over__main__info--Color | #06c | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal--GridTemplateColumns | fit-content(100%) | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__main--TextAlign | left | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__main--GridTemplateColumns | 1fr auto | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__main--GridTemplateAreas | "title upload"
"info upload" | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__main--Gap | 0.5rem 3rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__main--PaddingBottom | 1.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__title--GridTemplateColumns | auto 1fr | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__title--Gap | 0.25rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__title-text-separator--Display | inline | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__title-text-separator--MarginTop | 0 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload--m-horizontal__info--MarginTop | 0 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-progress--GridTemplateColumns | auto 1fr | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-progress--Gap | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-progress-icon--Color | #6a6e73 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--PaddingTop | 1rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--PaddingBottom | 1rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--first-child--PaddingTop | 0 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--GridTemplateColumns | auto 1fr auto | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--Gap | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--BorderWidth | 1px | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item--BorderColor | #d2d2d2 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-icon--Color | #6a6e73 | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-close--MarginTop | calc(0.375rem * -1) | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-progress--GridTemplateColumns | fit-content(100%) max-content | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-progress--Gap | 0.5rem | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-progress-text--Color | #06c | |
.pf-c-multiple-file-upload | --pf-c-multiple-file-upload__status-item-progress-size--Color | #6a6e73 | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload--GridTemplateColumns | fit-content(100%) | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__main--TextAlign | left | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__main--GridTemplateColumns | 1fr auto | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__main--GridTemplateAreas | "title upload"
"info upload" | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__main--Gap | 0.5rem 3rem | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__main--PaddingBottom | 1.5rem | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__title--GridTemplateColumns | auto 1fr | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__title--Gap | 0.25rem | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__title-text-separator--Display | inline | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__title-text-separator--MarginTop | 0 | |
.pf-c-multiple-file-upload.pf-m-horizontal | --pf-c-multiple-file-upload__info--MarginTop | 0 | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__main--BorderStyle | solid | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__main--BorderColor | #06c | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__main--BackgroundColor | #e7f1fa | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__title-icon--Color | #06c | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__title-text--Color | #06c | |
.pf-c-multiple-file-upload.pf-m-drag-over | --pf-c-multiple-file-upload__info--Color | #06c | |
.pf-c-multiple-file-upload__status-item:first-child | --pf-c-multiple-file-upload__status-item--PaddingTop | 0 | |
View source on GitHub