Angular File

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

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

##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

modulr / mdr-angular-file

Angular File

Copyright and license

About

Languages