mdr-angular-file

Angular File

Angular File is an Angularjs component that can upload files via XMLHttpRequest, provides drag & drop support.

• Demo
• Backend and Frontend examples

Features

• Uses the native Angularjs scope for data binding
• Drag & Drop
• Multiple or single files uploads
• Image preview
• Update progress
• Large files support

Requirements

• Angularjs
• Bootstrap 3.

Quick start

Several quick start options are available:

• Download the latest release
• Clone the repo: git clone https://github.com/Modulr/mdr-angular-file.git.
• Install with Bower: bower install mdr-angular-file.
• Install with npm: npm install mdr-angular-file.

What's included

mdr-angular-file/
  dist/
    ├── mdr-file.css
    ├── mdr-file.min.css
    ├── mdr-file.js
    └── mdr-file.min.js

Documentation

Usage

Load CSS

<link href="mdr-angular-file/dist/mdr-file.min.css">

Load JS

<script href="mdr-angular-file/dist/mdr-file.min.js"></script>

Code

angular.module('MyApp', ['mdr.file'])

HTML View or Templates

Basic Directive

<mdr-file url="upload.php"></mdr-file>

Complete Directive (All attributes)

<mdr-file url="upload.php" model="model" data="{hola:'mundo'}" headers="{token:'shhh'}" size="5" limit="10" formats="'jpg,png,gif'" disabled="true" multiple="true" text="Arrastra o haz clic aquí"></mdr-file>

API

Attributes

Attribute	Type	Description
url	string	Is the path on the server where the file will be uploaded. Note: The parameter received on the server is file
model	object	It is the scope model where will be received to response the server.
data	object	Data to be sent to the server.
headers	object	Send headers to the server.
size	number	Max size in MB to file.
limit	number	Max number files to upload.
formats	string,array	Extensions permitted to the file.
multiple	boolean	If required to upload a multiple file is marked as true.
disabled	boolean	If required disable the component is marked as true.
text	string	Text into area drag and drop.

How to contribute

All contributions are very welcome, We love it. There are several ways to help out:

• Create an issue on GitHub, if you have found a bug
• Write test cases for open bug issues
• Write patches for open bug/feature issues, preferably with test cases included
• Contribute to the documentation

There are a few guidelines that we need contributors to follow so that we have a chance of keeping on top of things.

If you want to making changes Better avoid working directly on the master branch, to avoid conflicts if you pull in updates from origin, so, if make your contribution under the branch dev, into folder src/.

Community

• Implementation help may be found at Stack Overflow (tagged mdr-file).

Creators

@AlfredoBarronC

Copyright and license

Code and documentation (c) Copyright 2015 Modulr. Code published under license MIT