React Images Uploader

React.js component for uploading images to the server

Examples

Example for multiple images:

import React, { Component } from 'react';
import ImagesUploader from 'react-images-uploader';
import 'react-images-uploader/styles.css';
import 'react-images-uploader/font.css';
 
export default class MyUploader extends Component {
    render() {
        return (
            <ImagesUploader
                url="http://localhost:9090/multiple"
                optimisticPreviews
                onLoadEnd={(err) => {
                    if (err) {
                        console.error(err);
                    }
                }}
                label="Upload multiple images"
                />
        );
    }
}

Example for one picture:

import React, { Component } from 'react';
import ImagesUploader from 'react-images-uploader';
import 'react-images-uploader/styles.css';
import 'react-images-uploader/font.css';
 
export default class MyUploader extends Component {
    render() {
        return (
            <ImagesUploader
                url="http://localhost:9090/notmultiple"
                optimisticPreviews
                multiple={false}
                onLoadEnd={(err) => {
                    if (err) {
                        console.error(err);
                    }
                }}
                label="Upload a picture"
                />
        );
    }
}

Example server (Node.js, Express)

you need to install cors-prefetch-middleware and images-upload-middleware from npm.

import express from 'express';
import corsPrefetch from 'cors-prefetch-middleware';
import imagesUpload from 'images-upload-middleware';
 
const app = express();
 
app.use('/static', express.static('./server/static'));
 
app.use(corsPrefetch);
 
app.post('/multiple', imagesUpload(
    './server/static/multipleFiles',
    'http://localhost:9090/static/multipleFiles',
    true
));
 
app.post('/notmultiple', imagesUpload(
    './server/static/files',
    'http://localhost:9090/static/files'
));
 
app.listen(9090, () => {
    console.log('Listen: 9090');
});

Other servers

• Server on Go
• Server on Clojure

Props

• url: string - server url;

• classNamespace: string - namespace for all classNames (default: 'iu-');

• inputId: string - id and name for hidden input type file. Used for htmlFor in label (default: 'filesInput');

• label: string - label text;

• images: Array - an array of references to the already uploaded images;

• disabled: boolean;

• onLoadStart: function() - callback, which is called when the download starts;

• onLoadEnd: function(error: { message: string, ... }, response?: JSON)

  Error messages:

  • invalid response type - additional params: response, fileName (imagesUploader);
  • server error - additional params: status (response status), fileName (imagesUploader);
  • exceeded the number - if there is max property and files count > max;
  • file type error - additional params: type (file type), fileName (imagesUploader);

• deleteImage: function(key: number) - callback which is called when the image has been deleted from the list;

• clickImage: function(key: number) - callback which is called when the image preview is clicked;

• optimisticPreviews: boolean - enables optimistic previews default: false;

• multiple: boolean - allows to upload a bunch of images !default: true!;

• image: string - this property works only when multiple: false! already loaded picture;

• notification: string - this property works only with multiple: false! notification text;

• max: number - the maximum number of pictures for a single upload;

• color: string - color for text and svg default: '#142434';

• disabledColor: string - color for text and svg in disabled mode default: '#bec3c7';

• borderColor: string - border color default: '#a9bac8';

• disabledBorderColor: string - border color in disabled mode default: '#bec3c7';

• notificationBgColor: string - background color for notification default: 'rgba(0, 0, 0, 0.3)';

• notificationColor: string - text and svg color for notification default: '#fafafa';

• deleteElement: string|element - element for removing images;

• plusElement: string|element - element for adding images;

classNames: {
    container: string,
    label: string,
    deletePreview: string,
    loadContainer: string,
    dropzone: string,
    pseudobutton: string,
    pseudobuttonContent: string,
    imgPreview: string,
    fileInput: string,
    emptyPreview: string,
    filesInputContainer: string,
    notification: string,
}

styles: {
    container: Object,
    label: Object,
    deletePreview: Object,
    loadContainer: Object,
    dropzone: Object,
    pseudobutton: Object,
    pseudobuttonContent: Object,
    imgPreview: Object,
    fileInput: Object,
    emptyPreview: Object,
    filesInputContainer: Object,
    notification: Object,
}