Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

idcrop

Package Overview
Dependencies
Maintainers
1
Versions
38
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

idcrop

Image cropper utility that crops an image in any polygonal shape chosen and returns a base64 of the cropped area.

  • 2.0.6
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
74
increased by111.43%
Maintainers
1
Weekly downloads
 
Created
Source

IdCrop

code style: prettier

Image cropper utility that crops an image in any polygonal shape chosen and returns a base64 of the cropped area.

Usage

$ npm install idcrop
Javascript
const IdCrop = require("idcrop");

const idcrop = new IdCrop({
  displaySelector: "#display",
  toolbarSelector: "#toolbar",
  previewSelector: "#preview"
});

idcrop.init();
Configuration Object

The only required key in the configuration object is the CSS selector for the display area, but we have a bunch of configuration options that will be listed below.

  • displaySelector CSS selector for the containerof the display area (required, type CSS Selector)
  • toolbarSelector CSS selector for the container of the toolbar (default "" type CSS Selector)
  • previewSelector CSS selector for the container of the preview area (default "" type CSS Selector)
  • allowUpload Wether or not to allow image upload (default true type boolean)
  • numPoints Number of points (default 4 type integer)
  • croppingArea
    • overlayColor The color of the overlay around the cropping area (default "rgba(0, 0, 0, 0.7)" type CSS colors)
    • stroke Wether or not to add a stroke around the cropping area (default true type boolean)
    • strokeColor The color of the stroke around the cropping area (default "white" type CSS colors)
    • strokeDashed Wether or not the stroke is dashed (default true type boolean)
    • strokeWeight The weight of the stroke around the cropping area (default 2 type integer)
  • crop
    • overlayColor The color of the overlay around the crop (default "rgba(0, 0, 0, 0)" type CSS colors)
    • fillColor The color of the fill inside the crop (default false type boolean)
    • showImage Wether or not to show the image inside the crop polygon. (default true type boolean)
    • stroke Wether or not to add a stroke around the crop (default false type boolean)
    • strokeColor The color of the stroke around the crop (default false type boolean)
    • strokeDashed Wether or not the stroke is dashed (default false type boolean)
    • strokeWeight The weight of the stroke around the cropping area (default 0 type integer)
  • handles
    • class Any aditional classes to be added to the handles (default "" type string)
    • defaultStyles Wether or not to add the default styles to the handles. (default false type boolean)
Events

Some events are dispatched to the document in some key actions done to the cropper. These events are:

  • created Dispatched when the IdCrop is loaded or reset. detail The IdCrop configuration object.
  • handleCreated Dispatched when a new handle is created. detail The x and y position of the created handle.
  • resized Dispatched when a handle is moved. detail The new x and y position of the moved handle.
  • crop Dispatched when a crop action happens. detail The dataURI for the image created.
Getters

Right now we only have one getter method for the IdCrop which is:

  • idcrop.getPoints This method returns a list with all the points added to the image relative to the real image size.
HTML

You can create a container for display (cropping area), toolbar (for now, only filename) and preview (cropped area preview). Only the display area is required though.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <title>IdCrop</title>
    <link rel="stylesheet" type="text/css href="https://unpkg.com/idcrop@1.2.2/dist/css/main.min.css">
  </head>

  <body>
    <div id="display"></div>
    <div id="toolbar"></div>
    <div id="preview"></div>
  </body>
</html>

Development Environment Setup

$ npm install & npm start
Linting

We use a combination of eslint and prettier for the formatting and linting of our JS code.

$ npm run lint
$ npm run fix
Publishing

We have a small npm script that handles the bumping of the version and the publishing of the package for us.

$ npm --no-git-tag version <newversion>

License

Copyright © 2017, Idwall. Released under the MIT license.

Keywords

FAQs

Package last updated on 10 Jan 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc