Matreshka.js binders for drag'n'drop and file input
JavaScript
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
test
.babelrc
.eslintrc.js
.gitignore
.npmignore
.travis.yml
LICENSE
README.md
package-lock.json
package.json
webpack.config.js

README.md

file-binders npm version Build Status Coverage Status

The module includes 3 binder creators for Matreshka.js which allow to easily deal with files.

Usage

In browser environment these functions live at window.fileBinders object.

<script src="path/to/file-binders.min.js"></script>
const { file, dropFiles, dragOver } = fileBinders;
// ...
this.bindNode('file', node, file());

// if you don't want to create variables
this.bindNode('file', node, fileBinders.file());

The bundle can be downloaded at gh-pages branch


npm install --save file-binders
// import all binders
const { file, dropFiles, dragOver } = require('file-binders');

// import only needed binders
const file = require('file-binders/file');
const dropFiles = require('file-binders/dropfiles');
const dragOver = require('file-binders/dragover');

// ...

this.bindNode('file', node, files());

file(readAs)

Returns a binder for file input. The binder allows not only to get basic data about a file, but also to read it without calling FileReader manually.

If readAs argument isn’t set, input value gets into the bound property after its changing (on "change" DOM event). If readAs is set, binder will read the file and transform it into the needed format (data URI, Blob...) and only after reading the file, the property will be changed.

The file (native File) or an array of files becomes the final value of the property in the presence of multiple attribute. At the same time the result of reading will get into the object of every file as readerResult property.

Arguments

readAs [optional] (string) - the argument value can be "arrayBufer", "binaryString", "dataURL", "text". The value depends on the presence of corresponding methods of the FileReader prototype.

Example

this.bindNode('myKey', '.my-file', file('dataURL'));
// ... user changes input content
// choosing my-image.png from file system ...
this.on('change:myKey', function() {
	console.log(this.myKey);
	// -->
	// File
	//	lastModified: 1383404384000
	//	lastModifiedDate: ...
	//	name: "my-image.png"
	//	readerResult: "data:image/png;base64,iVBO..."
	//		- the result of file reading
	//	size: 9378
	//	type: "image/png"
});

dropFiles(readAs)

Returns a binder which allows to drop files from a file manager to given element. After bindNode is called HTML block gets needed DOM event listeners (eg, "dragover" and "drop"). When user drops files from file manager into the block, the property gets an array of dropped files as its value. As like file the binder accepts one optional argument called readAs which says how the files need to be read by FileReader: data URI, Blob... (the result of reading is placed in readerResult property of every file). If readAs isn't given, the property gets an array of files which wasn't read.

Arguments

readAs [optional] (string) - the argument value can be "arrayBuffer", "binaryString", "dataURL", "text". The value depends on the presence of corresponding methods of the FileReader prototype.

Example

this.bindNode('myKey', '.drop-area', dropFiles('dataURL'));
// ... user drops one file called
// "my-image.png" into .drop-area block
this.on('change:myKey', function() {
	console.log(this.myKey[0]);
	// -->
	// File
	//	lastModified: 1383404384000
	//	lastModifiedDate: ...
	//	name: "my-image.png"
	//	readerResult: "data:image/png;base64,iVBO..."
	//		- the result of file reading
	//	size: 9378
	//	type: "image/png"
});

dragOver()

Makes given property equal to true when something is dragged over given node.

Arguments

none

Examples

this.bindNode('myKey', '.my-node', dragOver());
this.on('change:myKey', function() {
	if(this.myKey) {
		console.log('something is dragging over .my-node');
	} else {
		console.log('nothing is dragged over the node');
	}
});

Add dragovered class name when file (or another draggable object) is dragged over .my-node

this.bindNode('myKey', '.my-node', dragOver());
this.bindNode('myKey', '.my-node', className('dragovered'));