Skip to content
React file input component for complete control over styling and abstraction from file reading.
JavaScript
Branch: master
Clone or download
Latest commit ee82924 May 24, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Add flow type system and remove prop-types dependency Mar 19, 2018
src
tests
.babelrc Add flow type system and remove prop-types dependency Mar 19, 2018
.flowconfig
.gitignore
CHANGELOG.md changelog Oct 27, 2015
LICENSE
README.md
package-lock.json
package.json v2 May 25, 2018

README.md

react-file-reader-input

React file input component for complete control over styling and abstraction from file reading.

<FileReaderInput as={dataFormat} onChange={handler} {...props}/>

  • as (string): what format the FileReader should read the file as (i.e., buffer, binary, url, text). Defaults to url.
  • children (element): if children is passed into FileReaderInput, then the component will hide the native file input and instead display children. Whenever the custom children are clicked, the component will trigger the native file input prompt. This allows complete control over styling an display.
  • onChange (function): callback function(event, results). Results will be an array of arrays, the size of which depending on how many files were selected. Each result will be an array of two items:
    • progressEvent: result[0] is a ProgressEvent object. You can retrieve the raw results at progressEvent.target.result among other things.
    • file: result[1] is a File object. You can retrieve the file name at file.name among other things.

All other props on FileReaderInput will be passed down to the native file input.

Usage

import React from 'react';
import FileReaderInput from 'react-file-reader-input';


class MyComponent extends React.Component {
  handleChange = (e, results) => {
    results.forEach(result => {
      const [e, file] = result;
      this.props.dispatch(uploadFile(e.target.result));
      console.log(`Successfully uploaded ${file.name}!`);
    });
  }
  render() {
    return (
      <form>
        <label htmlFor="my-file-input">Upload a File:</label>
        <FileReaderInput as="binary" id="my-file-input"
                         onChange={this.handleChange}>
          <button>Select a file!</button>
        </FileReaderInput>
      </form>
    );
  }
}
You can’t perform that action at this time.