@cropper/element-image

@cropper/element-image

A custom image element for the Cropper.

Main npm package files

dist/
├── element-image.js         (UMD, bundled)
├── element-image.min.js     (UMD, bundled, compressed)
├── element-image.raw.js     (UMD, unbundled, default)
├── element-image.esm.js     (ECMAScript Module, bundled)
├── element-image.esm.min.js (ECMAScript Module, bundled, compressed)
├── element-image.esm.raw.js (ECMAScript Module, unbundled)
└── element-image.d.ts       (TypeScript Declaration File)

Getting started

Installation

npm install @cropper/element-image

Usage

import CropperImage from '@cropper/element-image';

CropperImage.$define();

<cropper-image></cropper-image>

Versioning

Maintained under the Semantic Versioning guidelines.

License

MIT

Changelog

2.1.0 (2025-10-19)

• docs: fix value of free aspect ratio (5b4e96f), closes #1274
• refactor(element-shade): use selection itself when default prevented (0673f15)
• fix(element-image): ensure the image is fully rendered (5afd8f3), closes #1168
• fix(element-selection): get correct event target in shadow DOM (#1276) (e64d6c3), closes #1276
• fix(element-shade): fix shade size when selection changes (98c101c)
• fix(element): call attachShadow only if shadowRoot does not exist (75cabcf), closes #1217
• feat(cropperjs): add destroy method (6a933e3), closes #1271