@cropper/element-selection

@cropper/element-selection

A custom selection element for the Cropper.

Main npm package files

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

Getting started

Installation

npm install @cropper/element-selection

Usage

import CropperSelection from '@cropper/element-selection';

CropperSelection.$define();

<cropper-selection></cropper-selection>

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