Easy to use Angular2 directives for files.
Quick start
A recommended way to install ng2-file-upload is through npm package manager using the following command:
npm i ng2-file-upload --save
Alternatively, you can download it in a ZIP file.
Currently, ng2-file-upload contains two directives: ng2-file-select and ng2-file-drop. ng2-file-select is used for 'file-input' field of form and ng2-file-drop is used for area that will be used for dropping of file or files.
More information regarding using of ng2-file-upload is located in demo and demo sources.
API for ng2FileDrop
Properties
uploader - (FileUploader) - uploader object. See using in demo
Parameters supported by this object:
- url - URL of File Uploader's route authToken
- Auth token that will be applied as 'Authorization' header during file send.
disableMultipart - If 'true', disable using a multipart form for file upload and instead stream the file. Some APIs (e.g. Amazon S3) may expect the file to be streamed rather than sent via a form. Defaults to false.
itemAlias - item alias (form name redefenition) formatDataFunction - Function to modify the request body. 'DisableMultipart' must be 'true' for this function to be called.
formatDataFunctionIsAsync - Informs if the function sent in 'formatDataFunction' is asynchronous. Defaults to false.
parametersBeforeFiles - States if additional parameters should be appended before or after the file. Defaults to false.
Events
fileOver - it fires during 'over' and 'out' events for Drop Area; returns boolean: true if file is over Drop Area, false in case of out. See using in ts demo and html demo
onFileDrop - it fires after a file has been dropped on a Drop Area; you can pass in $event to get the list of files that were dropped. i.e. (onFileDrop)="dropped($event)"
GitHub Link: https://github.com/valor-software/ng2-file-upload