upload ui component for react

Usage no npm install needed!

<script type="module">
  import rcUpload from 'https://cdn.skypack.dev/rc-upload';



React Upload

NPM version dumi build status Test coverage Dependencies DevDependencies npm download bundle size


npm install
npm start



online example: https://upload.react-component.vercel.app/


  • support IE11+, Chrome, Firefox, Safari




var Upload = require('rc-upload');
var React = require('react');
React.render(<Upload />, container);



name type default description
name string file file param post to server
style object {} root component inline style
className string - root component className
disabled boolean false whether disabled
component "div" "span" "span"
action string | function(file): string | Promise<string> form action url
method string post request method
directory boolean false support upload whole directory
data object/function(file) other data object to post or a function which returns a data object(a promise object which resolve a data object)
headers object {} http headers to post, available in modern browsers
accept string input accept attribute
multiple boolean false only support ie10+
onStart function start upload file
onError function error callback
onSuccess function success callback
onProgress function progress callback, only for modern browsers
beforeUpload function null before upload check, return false or a rejected Promise will stop upload, only for modern browsers
customRequest function null provide an override for the default xhr behavior for additional customization
withCredentials boolean false ajax upload with cookie send
openFileDialogOnClick boolean true useful for drag only upload as it does not trigger on enter key or click event

onError arguments

  1. err: request error message
  2. response: request response, not support on iframeUpload
  3. file: upload file

onSuccess arguments

  1. result: response body
  2. file: upload file
  3. xhr: xhr header, only for modern browsers which support AJAX upload. since 2.4.0


Allows for advanced customization by overriding default behavior in AjaxUploader. Provide your own XMLHttpRequest calls to interface with custom backend processes or interact with AWS S3 service through the aws-sdk-js package.

customRequest callback is passed an object with:

  • onProgress: (event: { percent: number }): void
  • onError: (event: Error, body?: Object): void
  • onSuccess: (body: Object): void
  • data: Object
  • filename: String
  • file: File
  • withCredentials: Boolean
  • action: String
  • headers: Object


abort(file?: File) => void: abort the uploading file


rc-upload is released under the MIT license.