bahaaldine / angular-csv-import

Angular component that lets you import and convert CSV file to JSON
MIT License
150 stars 89 forks source link

Build Status Built with Grunt

Angular CSV Import

Demo page

http://bahaaldine.github.io/angular-csv-import

Installation

Install depedencies using bower:

bower install angular-csv-import

Add js libraries to your application:

    ...
    <script src="https://github.com/bahaaldine/angular-csv-import/raw/master/bower_components/angular-csv-import/dist/angular-csv-import.js"></script>
    ...

Add ngCSVImport module to you application

    ...
    angular
      .module('myAwesomeApp', [
        ...
        'ngCsvImport',
        ...
      ])
    ...

Usage

Include the ng-csv-import element with its options:

<ng-csv-import content="csv.content"
    material
    md-button-class="md-icon-button md-raised md-accent"
    md-svg-icon="file:ic_file_upload_24px"
    header="csv.header"
    separator="csv.separator"
    result="csv.result"
    accept="csv.accept"></ng-csv-import>

If multiple attribute setted the directive will thow an error due a not implemented yet logic.

Attribute to tell to the directive to activate the material power!

Attribute to personalize the md-button inside the directive

The icon to show in md-button

A variable which will contain the content loaded by the file input

A variable that says whether or not the source CSV file contains headers

A variable to toggle header visibility

A variable containing the separator used in the CSV file

A variable to toggle separator visibility

A variable to set the CSV file encoding

A variable to toggle encoding visibility

A variable which will contain the result of the CSV to JSON marshalling.

An optional variable to limit what file types are accepted. Ex. ".csv" to only accept csv file types.

An optional variable to limit the size of the files that are accepted in bytes. Ex. "1024" to only accept files up to 1kB.

An optional variable to pass in a callback to execute if the user attempted to upload a file larger than csv.acceptSize. Will run instead of parsing.

An optional variable to pass in a callback to execute once the file has been parsed. Will run following any successful parsing (ie change file, change separator, etc...).