react-dfb
v1.0.4
Published
A button to allow to download file without href link
Downloads
23
Readme
REACT Download File Button
Installation
yarn add -D react-dfb
or
npm i --save-dev react-dfb
Usage
import DownloadButton from 'react-dfb';
// you can also import flow type if needed
import type { DownloadData } from 'react-dfb';
Two required props:
- onClick: Function to call on button click
- downloadData: Object having html5 file informations (can be empty):
- mime: the mime type of the file to download
- fileName: the name (with extension) of the file to download
- contentBase64: the base-64 encoded content of the file to download
Optionnal props:
- label: text to be displayed on the button
- disabled: set true to disable button (default false) - Note that will also disable onClick propagation
- className: set a value to specify class (default empty)
- style: set a value to specify style (default empty)
You can have a simple html button
<DownloadButton onClick={...} downloadData={...}/>
Or use it with any other component, for example with a RaisedButton from material-ui:
import RaisedButton from 'material-ui/RaisedButton';
<DownloadButton onClick={...} downloadData={...}>
<RaisedButton
id="downloadButton"
label={...}
primary={true}
/>
</DownloadButton>
In this case, no need to set RaisedButton onClick, it will be retrieved from DownloadButton one.
Simple use case
- Set downloadData as an empty oject ()
- When file content has been retrieved, update downloadData and set type mime, file name and content File will automatically be proposed to download
How it works
The idea of this component is to create a http <a> tag, with a download attribute and simulate a click on it. Using URL.createObjectURL() function, a file content can be transformed into a link an put into the href of this <a> tag.
This implementation require that the service retrieving your file content return it base-64 encoded. Ideally, it should have the same parameters as the DonwloadData type