1.0.3 • Published 3 years ago

@appvitalinc/file-upload-widget-api-angular v1.0.3

Weekly downloads
11
License
ISC
Repository
github
Last release
3 years ago

Core Features

  • Drag & Drop or Copy & Paste any file
  • Pick files from multiple sources including popular online file shares
  • Upload files straight to your own cloud storages: Amazon S3 bucket, Azure Blob container
  • Manage large file uploads efficiently using multipart chunk uploads.
  • Crop, rotate, flip and enhance photos to perfection with built-in photo editor
  • Generate thumbnails, apply text or image watermarks
  • Complete control with configurable options and much more

Demo/Examples

Angular version of all examples are included in this wrapper library.

See file picker in action here with example configurations demonstrating various features.

Quick Start

Install using npm:

npm install @appvitalinc/file-upload-widget-api-angular --save

Include ApvFilepickerModule in app.module.ts

import { BrowserModule } from "@angular/platform-browser";
import { NgModule } from "@angular/core";
import { AppComponent } from "./app.component";
import { ApvFilepickerModule } from "@appvitalinc/file-upload-widget-api-angular";

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, ApvFilepickerModule],
  bootstrap: [AppComponent],
})
export class AppModule {}

UI code in .html file

<button apvFilepicker apikey="YOUR_API_KEY">Open Filepicker</button>

Available inputs

NameTypeRequiredDefaultDescription
apiKeyStringTrueFilepicker api key
optionsApvFilePickerOptionsCheck ApvFilePickerOptions

Callbacks

NameFunctionRequiredDefaultDescription
onOpen()Fires when filepicker has been initialized and is ready.
onClose()Fires when filepicker popup is closed.
onCancel()Fires when filepicker is canceled.
onUploadStarted()Fires when file(s) uploading starts.
onUploadDone(ApvFilePickerResponse)Fires when uploading completes.
onUploadError(error)Fires when file(s) upload is failed.

Examples

Below you can find some quick basic implementations.

Open picker - Single file upload

component.ts

import { ApvFilePickerResponse, ApvFilePickerOptions } from '@appvitalinc/file-upload-widget-api-angular';

export class AppComponent implements OnInit {
  apikey: string;
  options: ApvFilePickerOptions;

  ngOnInit() {
    this.apikey = "YOUR_API_KEY";
    this.options = {
      multiple: false,
      outputfileoptions: {
        width: 500,
        height: 281,
        resizetype: "fit",
        resizeconflict: "pad",
        storage: [
          {
            name: "YOUR_STORAGE_CODE_ALIAS",  //add one at your account dashbaord
            path: "YOUR_STORAGE_FOLDER_PATH", //optional
          },
        ],
      },
      inputfileoptions: {
        allowedfileformats: "jpg,jpeg,gif,bmp,png,webp,zip,pdf",
        maxfilesize: 700000000,
        note:
          "File size restricted to: 10000 KB / File type restricted to: JPG, PNG, JPEG, PDF, DOC, DOCX, TXT, XML and ZIP.",
      },
    };
  }

  onOpen() {
    console.log("Modal open");
  }

  onClose() {
    console.log("Modal Close");
  }

  onCancel() {
    console.log("On Cancel");
  }

  onUploadDone(data: ApvFilePickerResponse) {
    console.log("onUploadStart", data);
  }

  onUploadStart() {
    console.log("onUploadStart");
  }

  onUploadError(error: string) {
    console.log("onUploadError", error);
  }
}

component.html

<button
  apvFilepicker
  [apikey]="apikey"
  [options]="options"
  (onOpen)="onOpen()"
  (onClose)="onClose()"
  (onCancel)="onCancel()"
  (onUploadDone)="onUploadDone($event)"
  (onUploadStarted)="onUploadStart()"
  (onUploadError)="onUploadError($event)"
>
  Open Filepicker
</button>

Documentation

You can find further documentation about available filepicker options and configuration details here at https://appvital.com/docs/file-uploader#Quickstart-Angular

Contributing

Any of your contributions or ideas are more than welcome. Please consider that we follow the conventional commits specification to ensure consistent commit messages and changelog formatting.