‚̧Nice Philanthropist Metalhead
    Wondering what‚Äôs next for npm?Check out our public roadmap! ¬Ľ

    @myog-io/ngx-chunk-file-upload-base
    TypeScript icon, indicating that this package has built-in type declarations

    1.3.1¬†‚Äʬ†Public¬†‚Äʬ†Published

    @myog-io/ngx-chunk-file-upload npm version npm downloads

    This Repository it's a fork from ng2-file-upload from valor software We want to continue mantaining this repository, any help is welcome!

    Angular 2 Style Guide Build Status Dependency Status

    Quick start

    1. A recommended way to install @myog-io/ngx-chunk-file-upload is through npm package manager using the following command:

    npm i @myog-io/ngx-chunk-file-upload --save

    Alternatively, you can download it in a ZIP file.

    1. Currently @myog-io/ngx-chunk-file-upload contains two directives: ngx-file-select and ngx-file-drop. ngx-file-select is used for 'file-input' field of form and ngx-file-drop is used for area that will be used for dropping of file or files.

    2. More information regarding using of @myog-io/ngx-chunk-file-upload is located in demo and demo sources.

    Using @myog-io/ngx-chunk-file-upload in a project

    1. Install as shown in the above section.

    2. Import FileUploadModule into the module that declares the component using @myog-io/ngx-chunk-file-upload:

    import { FileUploadModule } from '@myog-io/ngx-chunk-file-upload';

    1. Add it to [imports] under @NgModule:

    imports: [ ... FileUploadModule, ... ]

    1. Import FileUploader into the component:

    import { FileUploader } from '@myog-io/ngx-chunk-file-upload';

    1. Create a variable for the API url:

    const URL = 'path_to_api';

    1. Initialize it:

    public uploader:FileUploader = new FileUploader({url: URL});

    API for ngxFileSelect

    Properties

    • uploader - (FileUploader) - uploader object. See using in demo

    Events

    • onFileSelected - fires when files are selected and added to the uploader queue

    API for ngxFileDrop

    Properties

    • uploader - (FileUploader) - uploader object. See using in demo
    1. uploaderService - Your own uploaderService extending FileUploaderService
    2. authToken - Auth token that will be applied as 'Authorization' header during file send.
    3. 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.
    4. isHTML5 - item alias (form name redefenition)

    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)"

    UploaderService Example

    import { Injectable } from '@angular/core';
    import {
      FileUploaderService,
      FileItem,
      FileUploaderOptions,
      UploaderServiceOptions,
      UploaderLinksOptions,
    } from '@myog-io/ngx-chunk-file-upload';
    import { HttpClient } from '@angular/common/http';
     
     
    @Injectable()
    export class SimpleDemoService extends FileUploaderService {
      /**
       * Links for the Post of file, this links will go trough Interceptor, 
       * you can manipulate if necessary 
       */
      public links: UploaderLinksOptions = {
            downloadEntry: '/file/#id#/',
            updateEntry: '/file/#id#/',
            createEntry: '/file/',
            deleteEntry: '/file/#id#/',
        };
      /**
       * Uploader Options
       */
      public options: UploaderServiceOptions = {
        createMethod: 'POST',
        updateMethod: 'PATCH',
        authorizationHeaderName: 'Authorization',
        tokenPattern: 'Bearer #token#',
        token: null,
        chunkSize: 1024 * 1024 * 3,
        totalChunkParamName: 'total_chunks',
        currentChunkParamName: 'current_chunk',
        fileParamName: 'file',
        idAttribute: 'id',
      };
      constructor(protected http: HttpClient) {
        super(http);
      }
     
      /**
       * Determines whether before upload on
       * Place your Authentiaction Tactics here
       * @param item
       * @param options
       * @returns before upload
       */
      public onBeforeUpload(
        item: FileItem,
        options: FileUploaderOptions,
      ): Promise<any> {
        return new Promise((resolve, reject) => {
          resolve(true);
        });
      }
    }

    Troubleshooting

    Please follow this guidelines when reporting bugs and feature requests:

    1. Use GitHub Issues board to report bugs and feature requests (not our email address)
    2. Please always write steps to reproduce the error. That way we can focus on fixing the bug, not scratching our heads trying to reproduce it.

    Thanks for understanding!

    Using/Sending Chunk Files Feature

    If you want to send the files chunked you can just set the chunk paramets on the uploader object

    If your chunk request changes the link after the first request you should use this code

    this.uploader.onCompleteChunk = (item,response,status,headers)=>{
          response = JSON.parse(response);
          if(response['id']){
            item.setId(response['id']);
          }
      }

    Code snippet on how to use the Chunk File Feature on your code

    The Chunk functions are inside the Service, UploaderServiceOptions

      ...
      import { FileUploader } from '@myog-io/ngx-chunk-file-upload';
      ...
      export class SimpleDemoComponent {
        ...
        uploader:FileUploader;
        ...
        // SimpleDemoService is your Service to handle the Upload
        constructor (simpleDemoFileUploaderService: SimpleDemoService) {
          ...
            this.uploader = new FileUploader({
              uploaderService: simpleDemoFileUploaderService,
              authToken: 'pre_token',
              disableMultipart: false,
              isHTML5: true,
            });
            this.uploader.onBeforeUploadItem = (item) => {
                // If you use credentials this might help you with the "Access-Control-Allow-Origin" error
                item.withCredentials = false;
            };
            this.uploader.onCompleteChunk = (item, response, status, headers) => {
              //Insert the Logic here to start uploading next chunks
              // Example, setting the ID of the File uploaded and chaning the link for the next request
              // In my Case the API is using a put method with the link containing the PK of the object
              response = JSON.parse(response);
              if (response['id']) {
                // After settting ID, the Url will be changed
                item.setId(response['id']);
              }
            };
            this.uploader.onErrorItem = (item, response, status, headers) => {
               // Treat the error on the upload
               // On the chunk method we try to upload a chunk for 10 times before triggering this error
            };
            this.uploader.onRemoveItem = (item) => {
               // Treat the file removal from the server
            };
          ...
        }

    License

    The MIT License (see the LICENSE file for the full text)

    Install

    npm i @myog-io/ngx-chunk-file-upload-base

    DownloadsWeekly Downloads

    2

    Version

    1.3.1

    License

    MIT

    Unpacked Size

    439 kB

    Total Files

    74

    Last publish

    Collaborators

    • avatar
    • avatar