/multifile

jQuery Multiple File Selection Plugin

Primary LanguageJavaScriptMIT LicenseMIT

#jQuery Multiple File Upload

##Overview

[Flattr this git repo](https://flattr.com/submit/auto?user_id=fyneworks&url=https://github.com/fyneworks/multifile&title=Multiple File Upload&language=&tags=github&category=software)

MultiFile ($.MultiFile) is a non-obstrusive and crucially non-opinionated plugin for jQuery that helps your users easily select multiple files for upload.

It helps you implement a basic interface to improve the file selection experience of your users whilst providing you, the developer, with 3 simple methods of validation: accepted extensions, number of files and total size.


##Server-Side Implementation

This plugin will never deal with the server-side implementation of your upload solution. This plugin will not upload your files. If that's what you want, we recommend you check them out one of the many, many many great tools out there which provide a full solution - with image previews, progress bars and extensive support for many environments (.NET, PHP, Java, etc...).

And remember..... server-side validation is always required.


##Installation

First, get the package

Install with bower: bower install multifile or download zip from GitHub multifile.zip

Then, invoke the required javascript files to your document, just before the </html> tag.

Add jQuery to your page. We strongly recommend you make use of Google's Hosted Libraries service.

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>

Then add the plugin (after jQuery)

<script src="/path/to/plugin/jquery.MultiFile.min.js"></script>

##Recommended Usage (HTML5)

Just add multiple="multiple" and class="multi" attributes to your <input type="file"/>, like this:

<input type="file" multiple="multiple" class="multi"/>

Use the maxlength property if you want to limit the number of files selected. Server-side validation is always required

<input type="file" multiple="multiple" class="multi" maxlength="2"/>

Use the accept if you only want files of a certain extension to be selected Separate valid extensions with a "|", like this: "jpg|gif|png". Server-side validation is always required.

<input type="file" multiple="multiple" class="multi" accept="gif|jpg"/>

##Legacy Usage (pre HTML5)

Versions of HTML and xHTML prior to HTML 5 do not support the multiple="multiple" attribute. The plugin will still work in almost the same way, but your users will only be able to one file at a time.

<input type="file" class="multi"/>

Use the maxlength property if you want to limit the number of files selected. Server-side validation is always required

<input type="file" class="multi" maxlength="2"/>

Use the accept if you only want files of a certain extension to be selected Separate valid extensions with a "|", like this: "jpg|gif|png". Server-side validation is always required.

<input type="file" class="multi" accept="gif|jpg"/>

##Continous Integration with Travis CI

Master Status: full build history on Travis CI