ui-uploader

ui-uploader is a single/multiple and high customizable file uploader and the most important is very easy to implement.

• Upload multiple or single files
• Cancel or remove upload when you want.
• Allows concurrent Upload
• Totally cutomizable

You can use with html5, jquery or every library or framework:

The main objective of ui-uploader is to have a user control, clean, simple, customizable, and above all very easy to implement.

Try the demo.

Compatibility

Because this project uses FormData, it does not work on IE9 or earlier.

Requirements

• AngularJS

Usage

You can get it from Bower

1bower install angular-ui-uploader

Load the script files in your application:

1<script type="text/javascript" src="bower_components/angular/angular.js"></script>
2<script type="text/javascript" src="bower_components/angular-ui-uploader/dist/uploader.js"></script>

Add the specific module to your dependencies:

1angular.module('myApp', ['ui.uploader', ...])

Now you can use the ui-uploader methods.

1$uiUploader.addFiles(files);
2$uiUploader.remove(file);
3$uiUploader.removeAll();

Configure ui-uploader callbacks and start!

1$uiUploader.startUpload({
2                url: 'http://my_domain.com',
3                concurrency: 2,
4                onProgress: function(file) {
5                    // file contains a File object
6                    console.log(file);
7                },
8                onUploadSuccess: function(file) {
9                    // file contains a File object
10                    console.log(file);
11                },
12                onCompleted: function(file, responseText, status) {
13                    // file contains a File object
14                    console.log(file);
15                    // responseText contains the server response as text
16                    console.log(responseText);
17                    // status contains the status of the response
18                    console.log(status);
19                },
20                onCompletedAll: function(files) {
21                	// files is an array of File objects
22                	console.log(files);
23                }
24            });

Perform CORS AJAX requests by setting the options.withCredentials flag to true!

1$uiUploader.startUpload({
2                url: 'http://my_domain.com/path/to/api-endpoint',
3                options: {
4                	withCredentials: true
5                },
6                onProgress: function(file) {
7                    // do stuff
8                },
9                onUploadSuccess: function(file) {
10                    // do stuff
11                },
12                onCompleted: function(file, responseText, status) {
13                    // do stuff
14                },
15                onCompletedAll: function(files) {
16                	// do stuff
17                }
18            });

Configure custom request headers by options.headers field

1$uiUploader.startUpload({
2                url: 'http://my_domain.com',
3                concurrency: 2,
4                headers: {
5                    'Accept': 'application/json'
6                },
7                onCompletedAll: function(files) {
8                	// files is an array of File objects
9                	console.log(files);
10                }
11            });

Development

We use Karma and jshint to ensure the quality of the code. The easiest way to run these checks is to use grunt:

1npm install -g gulp-cli
2npm install && bower install
3gulp

The karma task will try to open Firefox and Chrome as browser in which to run the tests. Make sure this is available or change the configuration in karma.conf.js

Gulp watch

gulp watch will automatically test your code and build a release whenever source files change.

How to release

Use gulp to bump version, build and create a tag. Then push to GitHub:

1gulp release [--patch|--minor|--major]
2git push --tags origin master # push everything to GitHub

Travis will take care of testing and publishing to npm's registry (bower will pick up the change automatically). Finally create a release on GitHub from the tag created by Travis.