Skip to content
Siavash Samadi edited this page Sep 18, 2023 · 1 revision

Angular DropZone

Version 1.4.3

Click here to see the Changelog.

Getting Started

Installation

Install the package using NPM.

npm i @shsf1382/angular-dropzone

Usage / Examples

Adding the module

Import the Module in your app.module.ts file:

import { NgModule } from "@angular/core";
import { BrowserModule } from "@angular/platform-browser";

import { AngularDropzoneModule } from "@shsf1382/angular-dropzone";
// Import the module

import { AppComponent } from "./app.component";

@NgModule({
  declarations: [AppComponent],

  imports: [BrowserModule, AngularDropzoneModule],
  // Import the module in "imports" as well

  providers: [],
  bootstrap: [AppComponent],
})
export class AppModule {}

Adding the component

Add the Component in your app.component.html file:

<angular-dropzone [config]="myFileInputConfig"><angular-dropzone></angular-dropzone></angular-dropzone>

Note: You can add the attribute binding of [config] to configure the component's behavior through the myFileInputConfig object. You can name this object as you wish.

Configuring the options of the component

Configure the options in your app.component.ts:

import { Component } from "@angular/core";
import { FileProcessingConfig } from "@shsf1382/angular-dropzone";
// Import the config interface

@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
  styleUrls: ["./app.component.scss"],
})
export class AppComponent {
  myFileInputConfig: FileProcessingConfig = {
    maxFiles: 5,
    // Max files to be uploaded | Set to '10' by default

    allowedFileTypes: ["pdf", "docx", "xlsx"],
    // Allowed file types | Set to ['jpg', 'jpeg', 'png'] by default

    maxSize: 2,
    // Max size for upload in MB | Set to '2' by default

    defaultImage: "https://example-url.com/example.png",
    // Image to be dispalyed for non-image file types | Set to a default image

    display: "inline",
    // Controls file display method in the dropzone | Set to 'grid' by default
  };
}

Note: You can set the value of maxFiles, allowedFileTypes & maxSize to 'noRule'. This will remove the default rulesets of the component.